Note: For general information see Asset Workspace.

For a Step-by-step guide on how to create an Article see How Do I Create An Article in BLOX CMS.

new article asset editor


1. In BLOX CMS and BLOX Total CMS hosted go to Editorial / Assets and find the asset that needs to be removed, either temporarily or permanently.

2a. If this is a temporary removal, under Other / Miscellaneous properties check Do not publish.

2b. If this is a permanent removal you can delete the asset under Other / Miscellaneous properties by setting a Delete date/time.

2c. In the BLOX Total CMS appliance, check Do not publish or remove the site tag.

Note: If you delete the asset you will have up to 7 days to retrieve it. See How to retrieve a deleted asset.

Required Felds

Throughout BLOX CMS a required field will have a red dotted line below it.


All assets require a Title. In articles this acts as the web headline, in all other asset types it is the title of the asset. You cannot save an asset without a Title.

Start Date/Time

At the bottom of the asset editor is the Start Date/Time fields.

Start Date/Time serves three purposes:

  • Tells the system when the asset is allowed to become "live" on your site and be available to your readers (Start Date/Time only).
  • Can be used in conjunction with block Query Rules to determine which assets should be pulled into a block.
  • Used by the block Sorting Rules to determine what order assets should be displayed.

An asset cannot show up as "live" on the front end of your site until it has reached the Start Date/Time you set. Whether it goes live also depends on whether Do Not Publish is set in Other / Miscellaneous Properties. For more information, see Other (Flex) (Zen) document. The Start/Date Time will appear at the top of the Article and if it has been updated, it will display when it was last updated next to the Start Date/Time.

Note: What page and block the asset appears in is determined by how you set up your block Query Rules. See the How Do Assets and Blocks Work Together in BLOX CMS? doc.

Article has one required field, the article Title, or headline of the article. 

required title - Article Audio Collection HTML Table Video ZIP

Change, Add, or Delete an Author

The Authors field serves multiple purposes across the BLOX CMS, allowing admins to assign assets to a particular user, and allowing readers to follow and contact Authors on the front end.

Adding Authors

Authors must be a registered user of the site, and is generally an admin on your site, although they do not have to be. For more information about registered users see the Accounts doc. Authors can be added manually, or you can be added as the author automatically when you create a new asset. The Byline and Tagline fields (if there is one for that asset) can also be filled in automatically when an author is added to the asset.

Manually Add an Author
To manually add an author to an asset click the + icon in the top-right corner of the Authors field. this will open the Find user popup. You can manually scroll through the list of users to find the one you are looking for, or you can narrow your search by entering a full or partial name or email address into the Query field and clicking the Search button. You can also narrow your search by changing the Type of user to select either an Admin, a Normal (reader), or searching Both.

Select one or more users to add to the Authors field. To select multiple authors hold the CTRL key and click on multiple names to select non-consecutive names, or hold the Shift key and click the top and bottom names in the range you wish to select.

Automatically Adding an Author

To have yourself automatically added as the author when you click New asset go to the dropdown in the upper-right corner of the desktop (where it says Logged in as). Mouse over Preferences, then Default asset author, and click on Yes to have yourself set as the author everytime you create a new asset, or No if you do not want to be set as the author each time you create a new asset. These preference settings become attached to your account and will be set regardless of what device you log in on.

If the Byline and Tagline fields in user account are filled out, these fields will populate automatically (if there is one for that asset). For more information see the Accounts doc.

Body Copy

Body Copy is where you will type, or paste the body of your article.



There is a WYSIWYG editor for basic formatting of the asset text. Within the WYSIWYG you can format and align text, add inline comments (for your staff only), find and replace text, create numbered and bulleted lists, add horizontal rules and simple tables, add special charcters, edit the text's html source code. You can also embed video/media widgets, pull in Twitter Tweets, and Page Breaks. For more information on WYSIWYG, see What Does Each of The WYSIWIG Buttons Do in The Asset Editor?

Many HTML tags are automatically stripped from an asset in BLOX when the asset is saved.  BLOX uses the PHP tidy filter to attempt to clean code that may have errors.

HTML tags that will be stripped:

  • doctype
  • html
  • head
  • style
  • body
  • iframe

HTML tags that will not be stripped:

  • script
  • object
  • form, input, select
  • img
  • comments

Other tags will be converted to XHTML valid tags:

  • <i> becomes <em>
  • <b> becomes <strong>
  • <font size="5"> becomes <span style="font-size: large;">

Tags that are stripped out except in specific situtaons:

  • BR tags in general are removed if they are outside of "block" level elements

NOTE: If you want to keep the BR tags, you can put them inside of a block-level element, such as a div tag, and they should remain. Note that the div is counted as a paragraph as far as ads or paging in BLOX CMS.

NOTE: Inline elements, such as inline photos, can't be placed inside of a block-level element. So when you save it will be placed outside of the div.

Paste as Plain Text

If you are copying text from another program such as a word processing program, you should use the Paste as plain text button to paste in your text. This will ensure that any special characters that are not web friendly get removed. This is especially important if pasting in from Microsoft Word or any other rich text editor that adds font tags in the source code. You use CTRL + C to copy, and CTRL + V to paste in the Paste as plain text window.

Inline Notes

Inline Notes allows you to leave comments within the article text that are visible in the admin only. These notes do not appear on the front end of the website, and your readers will never see them. Inline Notes are NOT searchable in the admin.

Note: Inline notes do not transfer if an article is syndicated to another site (see Editorial / Syndication for more information about sharing assets between BLOX websites).

To create an inline note, place the cursor where you want the note to appear, click the mouse button, then click the inline notes icon. After you are done typing your note, move the cursor to the next location and continue editing the asset. Alternatively, you can highlight any existing text that you would like to be turned into an inline note, and select the inline notes icon. 

To remove an inline note, highlight the text and click the inline notes icon. This will remove the inline notes pencil icon. Then delete the text from the note.. If you do not remove the text manually, it will become part of the article and will be available for your readers to see on the front end.

Insert page break allows you to place a line that will break an article into multiple pages.

To create a page break, place the cursor where you want the note to appear, then click the insert page break button. This will place a broken line indicating where the page break will occur. On the front end, this will create forward and back buttons at the top and bottom of the article.

Note: This is for Flex only. Insert page break will add a horizontal line if used on Zen templates.

Note: When the page is printed out, the forward and back arrows along with the page numbers will be removed.


The Summary is displayed with the title as a precursor to the Article. If left blank, BLOX CMS will use the first paragraph or first couple of sentences. recommends that a Summary be used. As technology evolves, the Summary is what is used to report/broadcast "Headlines" and/or the "Days Top Stories" on devices such as Amazon's Alexa. Without the Summary, in many cases, the reporting is interupted/ends in mid-sentence.


Tagline is a brief comment or bio associated with the Authors which is used with TotalCMS and is displayed on the asset page in BLOX CMS. You can add a Tagline manually by typing information into that field, or you can have it added automatically if you add an author, and that author has the Content / Tagline field populated. For more information see the Accounts / Content doc. Tagline information can be searched through the general search at the top of the search terms.


Teaser only works with the Flex Templates and is used as a Preview Image for an Article Asset. Within the Article Asset Editor, click on Add to add in a Preview Image other than the Related Child Image Asset. The Preview Image pulls inline with the Article Asset in Editorial / Assets Search Results as you hover over it generating a popup thumb of the Asset. It also gets displayed on the front end where a normal Related Child Image Asset is positioned. Once you click on it, the Article Asset loads with the Related Child Image Asset being displayed instead of the Teaser Image.

For more details, Click here.

Cover Art

Cover Art another option in the Article Asset. It helps provide a way to personalize an Article/Story. This is most effective when trying to relay a "Long-form" presentation type Asset. For more information on using this setting, Click Here.