Media Captions

What is a caption?
A caption is a brief bit of text displayed beneath an image or video.

How is a caption different from the alternative text (alt text) required for accessibility?
Alternative text provides a description of the literal image or video in a way that provides a screen reading device the means to provide your visitor with a comparable experience to a sighted visitor. A caption can provide a description that includes context and additional details. Note that the caption is readable by a screen reader and is also visible to search engines for SEO purposes.

Where will captions display on my site if enabled?

  • Article page types - beneath the primary image/video (by default)
  • Blocks - beneath the image/video in WYSIWYG body regions
  • All pages - beneath the image/video in WYSIWYG body regions

How to add a caption to your media

  1. Navigate to Shortcuts » Media or Shortcuts » All content » Media tab.
  2. Either add a new piece of media or edit an existing piece that needs a caption.
  3. Locate the Caption field and enter in your text.
  4. Click Save to finish.

How to enable captions in your pages and blocks

Primary Media fields: when adding media to an Article's Primary Media field the caption will display automatically if one has been included via the Media Library.

Page and Blocks: When adding media to your page or block via the WYSIWYG, you will have the option to enable your caption; it will not display by default.

A screen shot of the Edit Media dialogue box showing the Caption box checked.
  1. Once you've selected and added your media, click the Edit media button at the top of your media.
  2. In the Edit media window, check the Caption box.
  3. Click Save to finish.







Creating a custom caption

In the WYSIWYG you may decide that media you used in one place needs a slightly different caption in a different place. Once the media is in place, you can click directly on the caption text in the page or block to edit it to your custom version.

Revert back to the original caption

Likewise, you may decide that you want to use the original caption stored in the media library. To do so:

  1. Click the Edit media button at the top of your media.
  2. In the Edit media window, uncheck the Caption box.
  3. Recheck the Caption box.
  4. Click Save to finish.