Content style guide
Alternative text for images
What alternative text is
Alternative text (also called “alt text”) is a written substitute for a visual image on a screen. Alt text provides the content and purpose of the image to people who can’t perceive the visual image.
Why we must provide relevant and meaningful alt text
This helps us make sure that everyone on VA.gov gets the same information—no matter how they interact with our site.
For example:
- People who are blind or have low vision can listen to the alt text description of an image on their screen reader.
- People who’ve turned off images on their device because they have low internet bandwidth can read the alt text description instead.
A note on decorative images
Images that are for decorative purposes only don’t require alt text.
Here’s when we consider an image decorative:
- The image doesn’t provide important context to the page content, and
- The image isn’t used as a link to direct people to more information
How to create quality alt text
Follow these 5 tips to create relevant and meaningful alt text:
- Provide the same meaningful information the image provides. Use clear, descriptive text to describe what the person needs to know from the image. Be sure to consider the context of the image within the surrounding page content as well.
- Be concise. Use as few words as possible to tell the person what they need to know. Aim for no more than 150 characters. Concise content allows people to focus on the most important information.
- Avoid duplicate page content. Only include unique information that’s not also in page content near the image. Repeating information can cause frustration or confusion.
- Skip phrases like “image of,” “photo of,” or “graphic of.” Screen readers already announce that each image is a graphic. So you don’t need to add this context.
- Leave the image file name out of your alt text. File names don’t provide useful information and can cause frustration or confusion.