1 Set Up
Understand the purpose of alternative text
Why alternative text matters
Alternative text, commonly called alt text, provides a text equivalent for visual content. It helps people who cannot see an image, chart, icon, diagram, or other visual understand the information or function that the visual contributes.
Alt text is especially important for people using screen readers, but its purpose is broader than naming an object. Effective alt text communicates the meaning a reader would otherwise gain from seeing the visual in its specific context.
Core principle
Describe what the audience needs to know from the visual. The same image may need different alt text when it is used for a different purpose.
Start by deciding whether the visual needs alt text
Before writing a description, determine the role of the visual. Not every image should be described. Some visuals convey information, some perform a function, some contain important text, and others are only decorative.
Ask these questions:
- Does the visual communicate information that is not already available in nearby text?
- Does the visual perform an action or identify the purpose of a link or button?
- Does the visual contain text that the reader needs?
- Is it a chart, diagram, map, infographic, or other complex visual?
- Is it present only for decoration or visual styling?
Decision rule
If removing the visual would cause a reader to lose information or functionality, provide an appropriate text alternative. If removing it would change nothing meaningful, it may be decorative.
2 Organize
Identify the visual’s role and context
Write for purpose and context
Good alt text is contextual. Do not try to create a universal description of an image. Instead, identify why the image appears in the document, presentation, website, or course material and describe the information that supports that purpose.
| Too Generic | More useful in context |
|---|---|
| Photo of students sitting around a table. | Students collaborate in small groups during laboratory activity. |
| Picture of a building. | Entrance to the Student Services Center on the east side of the building. |
| Graph with lines. | Enrollment increased steadily from 2022 through 2025, with the largest increase occurring in 2025. |
Useful test
Imagine explaining the visual to someone over the phone. Include the information they would need to understand why the visual is there.
Mark decorative visuals as decorative
A decorative visual adds appearance or atmosphere but does not provide information needed to understand the content. When the authoring tool supports it, mark such visuals as decorative so screen reader users can move past them without hearing unnecessary descriptions.
- Borders, flourishes, and purely stylistic shapes are often decorative.
- A stock photo used only to fill space may be decorative if it adds no information.
- A repeated icon next to text that already communicates the same meaning may be decorative.
- Do not mark a visual decorative simply because it is difficult to describe.
Context matters
A campus photograph used as page decoration may be decorative. The same photograph used to show the location of an accessible entrance is informative and needs a text alternative.
Do not duplicate captions or surrounding text
Alt text and captions serve different purposes. A caption may identify a figure, provide attribution, or add context for all readers. Alt text should fill in the visual information that a reader would otherwise miss.
- If the caption already communicates the complete meaning of the visual, avoid repeating it word-for-word.
- Use alt text to add necessary visual meaning that is not available in the caption.
- If nearby body text already provides a complete equivalent, the visual may need only a brief identification or may be treated as redundant depending on the platform and context.
Quality check
Listen to the caption and alt text together. If the same sentence would be announced twice, revise the experience.
3 Add Content
Write meaningful alternative text
Keep simple-image alt text concise
For a straightforward photograph, illustration, or icon, a short phrase or sentence is often enough. Include the details that matter to the surrounding content and leave out details that do not affect meaning.
- Lead with the most important information.
- Use plain, direct language.
- Include relevant people, objects, actions, settings, or relationships when they matter.
- Do not inventory every color, object, or background detail unless those details are important.
- Avoid repeating information that is already stated immediately next to the visual.
Avoid unnecessary phrases and file information
Screen readers generally identify an image as a graphic or image before reading its alternative text. Repeating that fact usually adds noise without adding meaning.
| Avoid | Better |
|---|---|
| Image of a professor speaking at a podium. | Professor Lee addresses graduates at commencement. |
| Graphic of a warning symbol. | Warning: high voltage. |
| Photo1234.jpg | Students use microscopes during a biology lab. |
| Screenshot.png | Accessibility Checker showing two missing-alt-text warnings. |
Length
There is no single correct character count for every situation. For simple visuals, aim for the shortest description that communicates the necessary meaning. If a full explanation is lengthy, use a longer description in the surrounding content instead of forcing everything into alt text.
Describe functional images by what they do
When an image functions as a button, control, or link, the text alternative should communicate the action or destination rather than just the icon’s appearance.
| Visual description | Functional alternative |
|---|---|
| Magnifying glass | Search |
| Printer icon | Print this page |
| Arrow pointing right | Next slide |
| CUNYlogo | CUNYhome page |
Core principle
For controls, describe the function. A user needs to know what will happen when the control is activated.
Handle images of text carefully
Whenever practical, present important words as real text rather than embedding them in an image. Real text can resize, reflow, be searched, and adapt more reliably to user settings.
- If essential text appears only inside an image, provide the same words in the text alternative or nearby content.
- If the visible text is already provided as real text next to the image, avoid unnecessary duplication.
- For logos, include the organization or product name when that identity is the important information.
- For screenshots, describe the interface state, message, or control that the screenshot is intended to demonstrate.
Avoid
Do not use alt text as a workaround for large amounts of text embedded in an image. Whenever possible, move the important content into real text.
4 Format
Handle specialized visual content
Write alt text for charts and graphs
A chart’s alt text should communicate the point of the chart, not simply identify its chart type. Readers need the trend, comparison, relationship, or conclusion that the visual is being used to show.
| Insufficient | Useful takeaway |
|---|---|
| Bar chart of enrollment. | Enrollment increased from 18,400 students in 2023 to 21,100 in 2025, with the largest year-over-year gain occurring in 2025. |
| Line graph showing website errors. | Accessibility errors declined each quarter, from 1,240 in Q1 to 430 in Q4. |
| Pie chart of survey results. | Sixty-eight percent of respondents preferred the new process; 22% preferred the previous process and 10% had no preference. |
If exact values, categories, or detailed comparisons are important, provide the underlying data in an accessible table or in a nearby text. Alt text can summarize the primary message while the longer alternative provides full detail.
Do not overload alt text
If the description becomes a paragraph of dense detail, move the detail into normal document or page content where it is easier to navigate and understand.
Describe diagrams, flowcharts, and processes
Complex diagrams often communicate relationships, sequence, hierarchy, or decision points that cannot be captured well in a short sentence. Provide a concise alt text summary and place the complete explanation in accessible text nearby.
- State the diagram’s overall purpose first.
- Describe the starting point, major stages or relationships, and outcome.
- Preserve meaningful sequence when the visual represents a process.
- For organizational charts, explain reporting or hierarchical relationships when those relationships matter.
- For decision trees, provide the decisions and resulting paths in text.
Provide longer descriptions for complex visuals
Some visuals contain too much information for useful alt text alone. Maps, detailed infographics, scientific figures, dense charts, and multi-part diagrams may require a longer text equivalent.
- Use short alt text to identify the visual and summarize its main purpose.
- Provide the full explanation in adjacent body text, a caption plus detailed description, an accessible data table, or another clearly identified location.
- Make sure the longer alternative contains the information needed to reach the same conclusion as the visual.
- Do not require a reader to infer important relationships from a list of disconnected labels.
Write alt text for screenshots
Screenshots are often used in instructions and training materials. Their alt text should support the task being taught rather than attempting to transcribe every item visible on the screen.
- Identify the application, page, or dialog when that context is important.
- Name the control, setting, message, or location the screenshot is demonstrating.
- If an arrow or highlight points to a control, explain that target in text.
- Keep the written instructions complete enough that the screenshot is supplementary rather than essential.
| Too broad | Task-focused |
|---|---|
| Screenshot of Microsoft Word. | Microsoft Word Review tab with Check Accessibility selected. |
| Screenshot of settings. | PowerPoint Alt Text pane with Mark as decorative selected. |
| Screenshot of website. | Course registration page showing the Submit button below the course selection table. |
Example: Alt text “Four-step procurement accessibility review from intake through final recommendation.” Nearby text can then list and explain all four steps in order.
Be thoughtful when describing people
Describe characteristics of people only when they are relevant to the purpose of the image and can be determined appropriately from the source or context. Focus first on actions, setting, and information the visual is intended to convey.
- Use names or roles when they are known and relevant.
- Describe visible actions and interactions rather than making assumptions about thoughts, emotions, identity, or personal characteristics.
- Include appearance details when the surrounding content makes those details important.
- Avoid unnecessary judgments or subjective descriptions.
Example: For an event recap, “President Rivera speaks with students at the welcome reception” is usually more useful than a detailed description of clothing and background objects.
5 Check
Review and improve your alt text
Review AI-generated alt text before using it
Some authoring platforms can generate alternative text automatically. These suggestions can be a useful starting point, but automated descriptions do not know why an image was selected or what the author intends the audience to learn from it.
- Review every generated description before approving it.
- Correct factual errors, vague labels, and irrelevant details.
- Rewrite the description so it reflects the visual’s purpose in context.
- Remove system-generated comments or confidence statements that are not part of the intended alternative.
- Do not assume automatically generated alt text satisfies accessibility requirements simply because the field is populated.
Final review before publishing
Before publishing or sharing content with visuals, review the alternative-text experience manually:
- Every meaningful visual has an appropriate text alternative.
- Decorative visuals are correctly identified as decorative where supported.
- Alt text communicates purpose and context rather than merely naming the object.
- Functional images describe their action or destination.
- Charts communicate their main takeaway and detailed data is available when needed.
- Complex visuals have a longer accessible description when short alt text is insufficient.
- Screenshots support the task and do not replace complete written instructions.
- Alt text does not unnecessarily repeat captions or nearby text.
- Automatically generated descriptions have been reviewed and edited.
- The document or platform’s accessibility checker has been run, followed by human review.
Human judgment is required
The author or content owner is responsible for deciding what information the visual contributes and whether the final text provides an equivalent experience.
6 Export
Add and maintain alternative text in Microsoft 365
Add alt text in Microsoft 365
In current Microsoft 365 versions, alt text can be added to pictures, charts, SmartArt, shapes, and other supported objects. Menu names can vary slightly by application and version.
- Select the visual object.
- Right-click and choose View Alt Text, or use the object’s Format tab and select Alt Text.
- Enter a concise description of the object’s meaning and context.
- If the object is purely decorative, select Mark as decorative when that option is available.
- Run Review > Check Accessibility and review any visual-content issues.
Charts and SmartArt
When adding alt text to an entire chart or SmartArt graphic, select the overall object rather than an individual component unless a specific component requires separate treatment.
Common Accessibility Mistakes
| Common problem | Better approach |
|---|---|
| A scanned PDF contains only images of text. | Run OCR, review recognition accuracy, then add and verify document structure. |
| A document is printed to PDF. | Create an accessible source and use a supported Save As or Export workflow that preserves structure. |
| The PDF contains tags, so it is assumed accessible. | Inspect whether the tags are correct, complete, and in a logical order. |
| A multi-column page reads across columns incorrectly. | Repair the reading order or return to the source and simplify the layout. |
| Alt text says only ‘image’ or ‘chart.’ | Describe the visual’s purpose or essential information. |
| A table uses a complicated grid with merged cells. | Simplify the table and verify header/data relationships. |
| A link says ‘click here.’ | Use link text that identifies the destination or action. |
| The accessibility checker passes, so review stops. | Complete manual checks for reading order, alt text quality, tables, navigation, and usability. |
| A form must be printed and completed by hand. | Provide accessible interactive fields or use an accessible alternative format. |
Quick Decision Guide
| Visual’s role | Recommended approach |
|---|---|
| The image conveys a simple idea or information. | Write concise alt text that communicates that meaning. |
| The image is a link, button, or control. | Describe the action or destination. |
| The image contains essential text not provided elsewhere. | Include the essential words in the alternative. |
| The image is a chart, diagram, map, or infographic. | Summarize the main point and provide a longer text equivalent when needed. |
| The same information is fully available in nearby text. | Avoid redundant description; treat appropriately for the platform and context. |
| The image is purely decorative. | Mark it decorative or use the platform’s supported null/empty alternative. |
Quick Checklist Before Sharing
- Each meaningful visual has an appropriate text alternative.
- Decorative visuals are marked decorative where the platform supports it.
- Descriptions focus on meaning, purpose, and context.
- Simple-image descriptions are concise and avoid unnecessary detail.
- Functional images describe the action or destination.
- Essential text shown inside an image is available as text.
- Charts and graphs communicate their primary takeaway.
- Complex visuals have an accessible longer description when necessary.
- Screenshots identify the interface element or task they are meant to demonstrate.
- Descriptions of people avoid unsupported assumptions and irrelevant personal characteristics.
- Alt text does not unnecessarily duplicate captions or nearby content.
- AI-generated alt text has been reviewed and edited by a person.
- Accessibility checking and manual review have been completed.
References and Further Guidance