Note: For general information see Asset Workspace.

NOTE: Images Assets should be .jpg, .png, or .gif file format. File types of .tif, .bmp, .jfif, and .psd will be converted to .jpg. The .pdf file will be flattened in the conversion process by BLOX CMS.

NOTE: The Cropping Image Asset tool is only available for .jpg and .png file formats.

NOTE: Images Assets cannot exceed 10 MB in size. They will be blocked from being uploaded. Animated .gif Images, cannot exceed 1 MB in size as they'll become a corrupted file.

For a Step-by-Step Guide on how to create am image, see Quick Start Guide: Create an Image Asset.

2 image.jpg


Image has two required fields, Title and an Image

Uploading an Image

Add image file allows you to upload a .jpg, .png, or .gif. For more information see Uploading an image.

Note: File sizes are limited to 10 MB. Additionally, it's recommended that images not exceed 3,000 pixels in width. Full-resolution photos that exceed these limitations can be stored in BLOX for archive purposes (Hi-res images will not appear within blocks) may be saved to the Hi-Res image field in the 'Other' tab.

Animated .gif images are limited to 1 MB in size.  Any larger and they'll be a corrupted file.

IPTC Information

If the image has IPTC (International Press Telecommunication Council) information embedded in it, that data will be pulled into the appropriate fields. The available IPTC fields are:  headline will go into the title field, photographer will go into the byline field, caption will go into the description field, and keywords will go into the keywords field.

For more information, the What is IPTC Information and How Does it Get Populated?.

7 image.jpg

Add, Change, or Remove a Preview Image

To Add or Change a Preview image in an asset...
You can add an image from your computer or network. Click on Change, then Upload a File. Use the Browse button in the Upload File dialogue window to search your computer or accessible network. Select the image and then select Upload File.

You can also upload an image from Dropbox. For more information about using Dropbox to upload images please see the Using Dropbox To Upload Images doc.

You can also add an image from an existing Image, YouTube, Video, or PDF asset already in your BLOX CMS. Click on Change, then Copy From Another Asset. Search for the image asset you are looking for, select it by clicking on the checkbox beside the name, and then click Add Selected Assets.

And finally you can remove the preview entirely by clicking on Change and Remove.

Best practice: You should have a preview image with your assets when applicable.

Note: Some blocks require a landscape or horizontal image to display properly. If the image is a portrait or vertical image it will show the middle of the image, cutting off the top and bottom of the image.

This will happen with ANY image. Your cropped preview should have a 16:9 aspect ratio. For more information about cropping Preview images for use with these blocks, see Step by Step Guide: Cropping Preview Images (Flex) (Zen)


Caption is used for the caption of the photo and can be displayed on the front end of the website.

4 image.jpg


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.