Alternative (Alt) Text

So you want to learn more about writing Alternative Text.

Well, you’ve come to the right place.

This resource guide is intended to help you learn the basics alternative text: what it is, how it’s used, and how to write more effective alternative text that improves digital access for all.

What is Alternative Text?

The purpose of “Alt” Text is to provide a short written description of an image or graphic so that screen readers can describe the image to users.

Alternative text is found in the metadata of your image-based digital content. While it isn’t “visible” to all users on the front-end of your content, assistive technologies like screen readers rely on alternative text in order to convey the purpose and context of the image to individuals who cannot perceive them (such as individuals with vision-related disabilities).

Every element that is recognized as an “image”, will be labeled as such by assistive technology. This applies to your:

  • logos

  • decorative elements (e.g., text boxes or flourishes)

  • icons

  • emojis

  • images

  • background graphics

  • and more.

But effective Alt Text is about more than describing what you see.

Playful Comic Strip, featuring two paintings in a museum. A speech bubble on top reads "A picture is worth a thousand words..." followed by another that says "...It's just too bad you're missing out on it".

The reality is that we use images to communicate all kinds of information, whether its through photographs, illustrations, charts and diagrams, icons, or another form of image. The visual content we use plays an important role in how we share and understand information in the digital world.

But what happens when someone can’t see those visual elements?

For many individuals, images without an accessible text alternative means missing out on critical information, context, and meaning. And this is particularly true when an image contains information that isn’t otherwise found elsewhere in the content.

Writing meaningful alternative text means understanding why the image is being used, what information it’s meant to communicate, and what someone would miss if they were not able to access or perceive it.

Tips for Writing Better Alt Text

Before writing your alt text, ask yourself why you’re utilizing a particular image. You can use the exact same photo in two separate pieces of content, and the alternative text can look completely different. A photograph of someone using a wheelchair, for example, could be used to demonstrate an accessibility feature, introduce a new team member, or simply be stock imagery of an individual in a wheelchair. Each of these calls for different alternative text.

Context Matters

Alternative text should provide enough information for someone to understand an image’s purpose, but shouldn’t overwhelm a user with unnecessary details.
While there is no universal word or character limit for alternative text, many platforms will restrict you to 120-150 characters, which is generally considered to be a good length. For images that require a more lengthy explanation, consider providing that information in an accompanying caption or in descriptive text below the image.

Be Descriptive, but Concise

Avoid using “Picture of” to start your alternative text. Assistive technology like screen readers automatically identify images to users. Instead, jump straight into the description.
An exception to this rule is in cases where the type of image is relevant to understanding its meaning. For example, identifying something as a painting, illustration, or screenshot can sometimes provide important context to the reader.

Avoid Unnecessary Introductions

Alternative text should describe what is important, relevant, and/or observable, but be weary of making assumptions about individuals, places, or circumstances depicted. For example, you may be able to describe an individual’s facial expression, but cannot necessarily determine how they’re feeling. Similarly, avoid assuming an individual’s identity, disability, or personal circumstances based solely on their appearance. (If you know the individual and know these are important to how they identity, this is different!)

Avoid Making Assumptions

Frequently Asked Questions About Alt Text

A Deaf Latina woman communicates in American Sign Language to colleagues in a conference room meeting.

Ready to Learn More?

Ready to dive in and learn more about all things alt text and digital accessibility?

Check out our hands-on and interactive workshops: