--- title: "Alternative (Alt) Text" slug: "alternative-alt-text" description: "Understand the importance of alt text for accessibility compliance. Learn how to write effective alt descriptions and why text within images should be avoided." updated: 2025-11-24T17:25:03Z published: 2025-11-24T17:25:03Z 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. ## 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. --- ## Alt Text or Title Text? The text contained in the alt attribute is used to describe the image to users who cannot view the image. Alt text is required for compliance with the ADA and provides a backup method of providing information to users who cannot view images. Title Text (labeled **Display Name** in Public Images) is not required for compliance, but may provide additional information for users. --- ## 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) 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. ## Related - [Access the Public Images Editor](/access-the-public-images-editor.md) - [Update Image Alt Text](/update-image-alt-text.md)