--- title: "Alternative (Alt) Text" slug: "alternative-alt-text" description: "Learn how to write effective alt text for images to ensure Americans with Disabilities Act compliance, improve accessibility, and support users with screen readers or image loading issues." updated: 2026-05-19T16:58:35Z published: 2026-05-19T16:58:35Z canonical: "www.civicplus.help/alternative-alt-text" --- > ## Documentation Index > Fetch the complete documentation index at: https://www.civicplus.help/llms.txt > Use this file to discover all available pages before exploring further. # Alternative (Alt) Text **Alt Text** describes images to users who are unable to view the images. A user may be unable to view images due to physical limitations or browser incompatibilities. Alt Text should be succinct and describe the content and function of an image. Any text displayed within an image should be included in the alt text. **Example Alt Text:** Stack of blueberry pancakes with maple syrup. The text contained in the alt attribute is used to describe the image to users who cannot view the image. The alt attribute will display when users hover their mouse over an image. Alt text is required for compliance with the ADA and provides a backup method of providing information to users who cannot view images. ## Text Within Images Screen-reading devices cannot detect text within an image. Additionally, images may not render properly depending on a user's browser or device. The text should be added to appropriate content widgets and should not be included in images unless as decoration or included in Logos. --- ## Resources - [WCAG (Web Content Accessibility Guidelines) Guideline 1.1 Text Alternatives](https://www.w3.org/TR/WCAG21/#text-alternatives) - [WCAG Success Criterion 1.4.9 Images of Text (No Exception)](https://www.w3.org/TR/WCAG21/#images-of-text-no-exception) - [Add a Single Image to Your Page](/municipal-websites-evolve/docs/add-a-single-image-to-your-page) - [Image and Slideshow Best Practices](/municipal-websites-evolve/docs/image-and-slideshow-best-practices) - [Add and Manage Assets in the HCMS](/civicplus-help-center/docs/add-manage-assets) Alternate Text. A text attribute applied within the properties of an image that describes the image for the use of screen readers and will display if the image does not load correctly. Americans with Disabilities Act. The Americans with Disabilities Act is a civil rights law that prohibits discrimination based on disability. It guarantees equal opportunity for individuals with disabilities in public accommodations, employment, transportation, state and local government services, and telecommunications.