Skip to Content

Digital Accessibility

Image Grid Alt Text

When you add images to an image grid or a flexible grid snippet, consider your link's purpose and length when writing each image's alt text.

Linking the Entire Grid Items

When you make the entire grid item a link in the flexible grid snippet, the accessible link name is made up of three parts:

  1. The image's alt text
  2. The title
  3. The description

The link name can become very verbose when you include all three parts at once, but if the image contains important text, then you'll need to include that in the alt text.


  1. The first grid image is marked as decorative. This effectively makes the accessible link name for the first grid item, "Alt Text in Omni CMS. Be on the lookout in Omni CMS for places to add alt text to your images." It is actually better to mark the image of the squirrel as a decorative image so that the link name does not become too lengthy and so that the function of the link is clear in the link name.

  2. However, the second grid image does require alt text. The image contains text on a digital sign, which is not included in our link text otherwise. The full link name, including the image's alt text, should be: "Follow Us @UofSC on Instagram, TikTok, and X. Alt Text in Social Media. Each social media platform has its own guides for adding alt text to your images."

Of course, this second link name could easily confuse someone using a screen reader into thinking that the link will take them to a page where they can follow @UofSC on social media. To make the purpose of this link clearer, it would be better if only the title were linked instead of the entire grid item.

It's best to be consistent with how you link your grid items—if you make the title the link in one grid item, make the title the link for all items within the snippet.

Note: If the linked image were the only item in the link—or in other words, if the link didn't include visible text—then the images would need alt text to convey the purpose of the link to somebody using a screen reader.

Adding & Replacing Alt Text

  1. Select your image, then click the Image icon to get to the Insert/Edit options.
    The top display of edit options for an Omni CMS page. A button with a folder icon is followed by four tab options, Preview, Edit, Properties, and Versions. To the right are four more buttons, the first with a checkmark, then a box icon and downward error, then with a yellow lightbulb icon, and finally, a green Publish button with a dropdown arrow. There is also a small gray circle with a white question mark in it next to the Publish button. The first row of icons includes Save, cancel, scissors, two stacked papers, a clipboard with an empty paper, a clipboard with filled paper, binoculars, undo and redo errors, spell check, italics, bold, bullets, numbered list, increase and decrease indent, quotation marks, x squared, x with a subscript, left align, center, right align, full width text, link, envelope, and anchor. The second row includes Paragraph and a dropdown, Styles and a dropdown, and an image icon in a garnet rectangle for emphasis followed by a dash, an arrow pointing left, C in a circle, a puzzle piece, two arrows in an oval, Insert component symbol, table with a dropdown, and four arrows pointing outwards to maximize content. The head on the page being edited includes the UofSC monogram, South Carolina, and Communications and Public Affairs.

  2. Determine if you should mark your image as decorative or not. You can tell screen readers to skip your decorative image if it conveys absolutely no important visual information, if it merely repeats information that is already on the page, or if its alt text would detract from the purpose of the link.

  3. Add your alt text to the "Alternative description" box or select the "Image is decorative" checkbox. Click "Save" to confirm.
    The Insert/Edit Image modal over an Image Grid Snippet. Empty fields for Source, Accessibility, and Alternative Description are emphasized with a garnet rectangle. The modal has two tabs, General and Advanced. General tab is selected and includes several options: Source text field and upload button, an unchecked Image is decorative box, Alternative Description text field, Image Title text field, Width and Height text fields with ratio lock icon, Class dropdown (not set), Custom Class text field, and ID text field. Cancel and Save buttons are at the bottom.

Challenge the conventional. Create the exceptional. No Limits.