Description
All non-text content that is presented to the user has a text alternative that serves the equivalent purpose, except for the situations listed below:
Controls, Input: If non-text content is a control or accepts user input, then it has a name that describes its purpose. (Refer to Guideline 4.1 for additional requirements for controls and content that accepts user input.)
Time-Based Media: If non-text content is time-based media, then text alternatives at least provide descriptive identification of the non-text content. (Refer to Guideline 1.2 for additional requirements for media.)
Test: If non-text content is a test or exercise that would be invalid if presented in text, then text alternatives at least provide descriptive identification of the non-text content.
Sensory: If non-text content is primarily intended to create a specific sensory experience, then text alternatives at least provide descriptive identification of the non-text content.
CAPTCHA: If the purpose of non-text content is to confirm that content is being accessed by a person rather than a computer, then text alternatives that identify and describe the purpose of the non-text content are provided, and alternative forms of CAPTCHA using output modes for different types of sensory perception are provided to accommodate different disabilities.
Decoration, Formatting, Invisible: If non-text content is pure decoration, is used only for visual formatting, or is not presented to users, then it is implemented in a way that it can be ignored by assistive technology.
Questions & Answers
How do I add alternative text to an element with role=”img”?
I have a <div> element with role="img" on my site but I am unsure how to add alternative text to the image.
- alt text
- labels
- role="img"
If images have captions, do they need alt text?
I have images on my page that include captions. Do I also need to write alternative text for the images?
- alt text
- captions
- images
Can I hide content while maintaining web accessibility?
How can I hide content while still maintaining web accessibility?
- aria
- CSS
- hidden content
What is the math HTML element?
What is the <math> element, and how does it affect accessibility?
- accessibility
- alt text
- audio
- math
How much alt text does my map need?
I’m updating a website with an apartment community map. The map includes a map legend and shows the locations of buildings, mailboxes, and other outdoor amenities like our BBQ grills. I’ve added alternative text to the map: “The River Drive apartment complex map and map...
- alt text
- complex images
- graphics
What do I do when an alt text field is too small for my description?
The alt text field is too small to contain all of the text in images of documents that I post. What's the solution and what are the applicable WCAG success criteria?
- alternative text
- images
How do I code an image as a link and make it accessible?
I have an image on my site that I want to code as a link? How do I code an image as a link and make it accessible?
- alt text
- images
- links
Do my product images need alternative text?
My product description is very detailed. Do my product images still need alternative text?
- alt text
- images
- user experience
How do I know if an image is decorative?
What's the best way to decide whether an image is meaningful or decorative?
- alt text
- decorative images
- graphics
- images
Users can upload images to my web app. Am I required to provide alt text?
Users can upload images to my web app. Am I required to provide alt text?
- alt text
- images
- user content