Photo Box

Building in the WCMS

Understanding Image “Type”

Any image uploaded to the WCMS is reusable and can be inserted into content as “image only,” image with caption (jumbotron), or photo box. When inserting an image, select “Image” as the element type and then, in the Settings pop-up, select one of these three display styles as its “type.”  The display options vary according to the type.

For details on maintaining and using images, refer to the topics on this page.

Uploading Images

From the WCMS content browser, there are two approaches to uploading a single image or multiple images in bulk:

  • Select the parent folder and then drag the image files into the content item list area on the right.
  • Select the parent folder and then click “New Content.”  When prompted, select “Images/Files” as the content type.

Note that, when you are selecting an image for placement on a page or in a content element such as a card, you can upload images.

  1. Click the “Select” button for the image field to open the Content Item Selector.
  2. Click the “Upload Image” button in the upper right corner of the Content Item Selector.
  3. Once you have added the images (and completed any bulk edits), click “Finished Uploading” in the upper right corner of the selector to return to the previous form and finalize the image selection.

Editing During Upload

During the image-upload process, you can bulk-edit the titles, alt text, and captions. As images are selected or dropped into the file selector, the WCMS compiles the images into a list.

Click the “Bulk Edit” button just above the list of uploaded images to turn on the inline editor for the images.  (Note that there is no save button.  Any changes to the titles, alt text, and captions are stored automatically.)

Editing After Upload

Once images are uploaded, you can access them individually from any browser (the main content browser, search results browser, relationships browser) by clicking the “Edit” link for the image when you hover over its title.

To crop or scale an image, open the image for editing and then click the “Edit Image” button just under the image preview.

Handling Alt Text

In most cases, when a user inserts an image into a page, he or she can edit the alt text (as well as title, caption, and a few other fields) for the specific location. However, in some cases — such as the page Feature Area — the alt text must be pulled from the saved image content item. For this reason, it’s always best to provide good alt text in the image content item.

Inserting an Image

Once you upload an image, you can insert it into Visual Composer or any WYSIWYG field:

  • Select the “New Element” option to open the Image Settings pop-up.
  • Select the image and define its usage-specific properties.  In most cases, you can select from multiple image sizes. Always select the smallest size that works for your location and need.
  • Use the “Type” field in Settings to specify the use of the image:  image only, image with caption (jumbotron), or photo box.
  • To constrain image size within a WYSIWYG field (typically for wrapping text around an image), in the Settings pop-up, set the Alignment field and then the Width (Grid Columns).
  • To always pull the image title, caption, etc. from the saved image item, check “Pull image information dynamically” in the Settings pop-up.  (Once you publish the page, if the image is edited, the page publish status changes to “Edits Not Published,” and you should re-publish the page.)

Note that, in some cases, like the Iconic Image and Feature Area for a page, you do not have the option of setting the image properties specific to the page.

Large Image Viewer Display Options

If you add a caption in the Edit Media page for an image, you can choose to display that caption on the page with the image, in the large image viewer, or both.

  1. The “Image with Caption” style must be selected as the Image Type in the image settings window.
  2. Check the pull image information dynamically box under general tab to connect to the image caption content.
  3. Select the large image viewer option on the advanced tab of the image settings.
  4. Then select which viewing option you want from the caption location dropdown below.
  5. The title can be displayed in the large image viewer modal as well if the show title box is selected from the general settings tab in the image settings window.

Replacing an Image

“Replacing an image” as the expression is used here involves editing the reusable image item.  This kind of image replacement — as opposed to merely switching out an image inserted on a page — changes the image in all locations where it is used.  Generally, you should replace an image with an image of the same size and dimensions.  The purpose of the replace-image option is to change the content of the image.

  1. From the content browser, open the image for editing.
  2. In the upper right corner of the Edit Media form, click the “Replace this Image/File” button.
  3. When prompted, select a replacement image and click Submit.

Do not change the image file name unless you know that the image is not in use.

Images in Alternative Languages

For a single image, you can provide alternative title, alt text, and caption in any of the standard languages supported in the page Language selector:

  1. Open the image for editing.
  2. In the Translations section, select a language in the Language drop-down. Then complete the Title, Alt Text, and Caption.
  3. To add these fields for another language, click the button “Add Another Translation.”  (To remove, click “Remove Translation.”)

When inserting into a page where you want the image’s alternative-language fields to be used, make certain the page Language is set to the appropriate language and save the page.  Then insert the image.


WCMS Quick Facts

You can bulk-upload images (up to 49 MB total).  In the content browser, just drag and drop image files into the item list (right side).

You can bulk-edit image titles, alt text, and captions immediately after uploading.  Click the “Bulk Edit” button above the list of uploaded images.

Depending on the size of the original image, the WCMS automatically creates up to four additional sizes or “renditions” of the image.  When you insert an image into a page or content element, select the smallest size for the location and need.

To change the content of an image in all places where it’s used, open the image for editing (from content browser) and click “Replace This Image/File” in upper right corner of Edit Media form.  For more details, see the instructions on this page.