Create Alt Text for Images

Prev Next

All images need to have succinct, accurate, and equivalent Alt Text. This will be read by screen readers and should present the content and function of an image.

Read more about alt text tips and tricks from the W3C (World Wide Web Consortium) WAI (Web Accessibility Initiative).

Important Note:

CivicPlus works toward WCAG 2.0 AA accessibility standards and our websites are highly compliant when they go live. However, ongoing ADA compliance and maintenance is the customer's responsibility.

Who can use this feature?

System Administrator | Owner | Publisher | Author

Alt Text Tips & Guidelines

  • Alt text should not contain redundant phrases like “image of” or “graphic of”

  • Alt text for two images cannot be the same.

    • If there are two photos of a river, for instance, on a page, either distinguish them by saying “River 1” and “River 2” or write more specific alt text such as “East side of the river” and “Close-up of river water”

  • If an image contains words, add as much of the text from the image as possible to the alt text (100-character limit).

  • Alt text should not contain file extensions, such as .jpg. It should be easily readable and describe what is happening in the image

    • See the following explanation for using file extensions in the alt text

Complex Images

  • Some examples of complex images can include charts, graphs, maps, or images of text.

  • When text is displayed in an image, that text should be used as the image's alt text.

  • A link should be provided to an accessible format of the image's information.

  • To learn more about how alt text can be applied to images of text, review the WCAG (Web Content Accessibility Guidelines) Success Criterion 1.4.5.

Linked Images

  • If the image functions as a link, the alt text should describe where the image will take the user

    • For instance, if an image showed a Swoosh and linked to the Nike Website, the appropriate alt text would be “Nike.” A screen reader would identify the link and add “site” or “link,” therefore writing “Nike Website” as alt text would be redundant, and “Nike Logo” would not make sense

  • If the image links to a document, the alt text should contain the file extension.

    • For example, if you have a cover image of the annual report, the alt text would be “Annual Report (PDF)”

  • If the image links to a larger version of itself, the alt text should read with the file extension

    • For example, an image of a map linking to a larger version of itself should have the alt text “Map of Downtown (JPG)”


Update Alt Text While Inserting an Image

  1. Sign in to your website

    Note:

    This process may look different based on how your site was designed.

  2. Navigate to the page you wish to add an image to

  3. Make sure the Live Edit state is toggled ON:

  4. Select the Widgets tab from the Live Edit panel:The Live Edit tabs with the Widgets tab highlighted.

  5. Click the Image Widget to drag-and-drop it in the location on the page: The Image widget being drag-and-dropped to a page.

  6. Locate the image to add to the page:

    Note:

    To easily locate your image, you can Search for its Display Name or ID:The Search for Display Name or ID field on the Content Images window.

  7. Click the Actions button next to the image: The Content Images pop-up box with the Actions button for an image highlighted.

  8. Select the Modify option: The Content Images pop-up box with the Action menu for an image expanded, and the Modify option highlighted.

  9. Add Alt Text to clearly explain what is happening in the image: The Content Images pop-up window with the Alt Text field for an image highlighted.

  10. Click the Save button in the Content Images pop-up window: The Content Images pop-up window with the Save button highlighted.

  11. Click the Insert button: The Content Images pop-up window with the Insert button for an image highlighted.

  12. (Optional) Edit the image as desired or create a linked image

  13. Click the Save button: The Save button in the top right corner of the page.


Add/Update Alt Text for an Existing Inserted Image

  1. Sign in to your website

    Note:

    This process may look different based on how your site was designed.

  2. Navigate to the page you wish to add an image to

  3. Make sure the Live Edit state is toggled ON:

  4. Click inside the Editor widget in which the image has been inserted

  5. Click the image to bring up the Image Toolbar:
    The Editor widget, opened for editing with the Image Toolbar displayed and highlighted.

  6. Click the Alt Text icon:
    The Editor widget opened for editing, with the Image Toolbar displayed and the Alt Text icon highlighted.

  7. Use the Alternative Text field to add or update the Alt Text for the image:
    The Editor widget with the Alternative Text field for an image displayed and highlighted.

  8. Click Update to finish your work:
    The Image Alternative Text field and the Update button highlighted.

  9. Click the Done Editing (checkbox) icon to close the Editor Widget
    The Done Editing (checkmark) button to close an Editor Widget.

  10. Click Save to save your work:
    The Save button in the top right corner of the page.


Additional Resources