Skip to content

Alt Text in Word: How to Write It for Images, Charts and Tables

By · · 10 min read

Title card reading Alt Text in Word, images, charts and tables, next to an icon of a picture above lines of text.

To add alt text in Word, right-click a picture, chart or shape, choose View Alt Text (or Edit Alt Text), and type a sentence or two that says what the image shows and why it is there. If the image is purely decorative, tick Mark as decorative instead. That is the whole mechanism. The harder part is deciding what to write, and the answer changes depending on whether you are describing a photo, a chart, a diagram or a table.

This guide covers the exact steps on Windows, Mac and Word for the web, then gives a method and examples for each kind of visual.

Key Takeaways

  • Alt text replaces the image for someone who cannot see it, so write what the image contributes, not what file it came from.
  • Keep it to a sentence or two and leave out "image of" or "picture of"; screen readers already announce that it is an image.
  • For charts, state the main finding in the alt text and put the detailed numbers in the text or a table nearby.
  • Tables get alt text through Table Properties, but a proper header row matters more.
  • Mark purely decorative images as decorative, and always review alt text that Word generates automatically.

What alt text does, and which images need it

Alt text (alternative text) is the description a screen reader reads aloud in place of an image. It is also what appears when an image cannot load, and it is carried into a tagged PDF when you save from Word. If an image has no alt text, a screen reader user may hear only that there is a picture, with no idea what it shows.

Not every image needs a description. The W3C's alt text decision tree sorts images into a few types, and the same logic works in Word:

Image type Example What to do in Word
Informative A photo of the new office entrance Describe what it shows that matters to the text
Complex A bar chart, a flow chart, an organisation chart Give the main point in alt text; put the detail in the document
Image of text A scanned notice, a quote set as a graphic Repeat the text, or better, use real text instead
Functional A logo that is also a link Describe where the link goes
Decorative A border, a divider line, a background flourish Tick Mark as decorative

The rule behind it all is in WCAG success criterion 1.1.1, Non-text Content: every non-text element that conveys information needs a text alternative that serves the same purpose.

How to add alt text in Word

Windows (Microsoft 365)

  1. Right-click the picture, chart, SmartArt graphic or shape.
  2. Choose View Alt Text. Some versions label it Edit Alt Text. You can also select the object and go to Picture Format > Alt Text (for a shape, Shape Format > Alt Text).
  3. The Alt Text pane opens on the right. Type your description in the box.
  4. If the image is decorative, tick Mark as decorative. The text box greys out.
  5. Close the pane. The text is saved with the image.

For a chart or SmartArt graphic, click its outer border before you open the pane. Microsoft's article on adding alternative text to a shape, picture, chart or SmartArt graphic points out that selecting one piece instead applies the alt text to that piece only.

Mac

Control-click (or right-click) the object and choose Edit Alt Text or View Alt Text, or select it and choose Alt Text on the Picture Format tab. The pane works the same way, including the Mark as decorative box.

Word for the web

Right-click the picture and choose the alt text option (labelled Alt Text or Edit Alt Text depending on the version), or select it and use Alt Text on the Picture tab. Type the description in the pane that opens.

How to write alt text for a photo or picture

Start by asking why the image is in the document. A photo of a building in a property report is there to show its condition; the same photo in a staff newsletter might be there to show where the new office is. The alt text should carry that purpose.

Microsoft's guide to writing effective alt text sets out a few rules:

  • Keep it short. Usually no more than a sentence or two. A few well-chosen words are often enough.
  • Describe what matters. Setting, people's expressions, colours or relative sizes, but only when they matter to the point.
  • Skip "image of" and "picture of". The screen reader already says it is an image.
  • Do not repeat the surrounding text. If the caption or paragraph already says it, the alt text can be brief.
  • Never use a file name or URL. "IMG_4032.jpg" tells the listener nothing. The Accessibility Checker flags this.
Weak alt text Better alt text
IMG_4032.jpg Front entrance of the Riverside office, with a ramp beside the steps
Image of a team Five volunteers in matching T-shirts packing food parcels at a long table
Logo Northfield Library logo
Graph (see the chart section below)

Write in the document's language, end with a full stop so the screen reader pauses, and spell out any text that appears in the image if it matters.

Practise it: Replace a file name used as alt text (free). The lesson on writing useful alt text has more examples.

How to write alt text for a chart or graph

Chart alt text should say what the chart shows, not just what kind of chart it is. Microsoft's alt text guidance gives the example of a bar chart described only as a chart of sales over time: accurate, but not useful, because the listener needs the trend or takeaway.

A pattern that works for most charts:

  1. Type and topic: "Bar chart of monthly helpdesk tickets, January to June 2026."
  2. Main finding: "Tickets fall from about 400 in January to about 150 in June, with the biggest drop after the new self-service portal launched in March."
  3. Where the detail is: "Exact figures are in Table 2."

The W3C's guidance on complex images is to keep the alt text brief and give the full information elsewhere on the page. In Word that means a sentence in the body text that states the finding, or a small data table next to the chart. That detail helps every reader, not only screen reader users.

1. Type and topic "Bar chart of monthly helpdesk tickets" 2. Main finding "Tickets fall from about 400 to about 150" 3. Where the detail is "Exact figures are in Table 2"
Chart alt text in three parts. The data itself belongs in the document, not in the alt text.

If the chart has a caption such as "Figure 3: Helpdesk tickets by month", the alt text can skip the topic and go straight to the finding.

Practise it: Write alt text for a chart (free).

How to write alt text for SmartArt, diagrams and flow charts

For a process or flow chart, Microsoft's alt text guidance suggests describing the starting point, how it progresses, and where it ends. For example: "Flow chart of the expenses process: submit a claim, manager approves or returns it, finance pays approved claims within the month."

If the diagram has more than a handful of steps, the alt text cannot carry it all. Write a short summary in the alt text and put the steps in a real numbered list in the document. SmartArt text is often readable on its own, but a summary still helps the listener understand how the pieces relate.

How to add alt text to a table

Tables are not images, so a screen reader can read their contents cell by cell. A short description still helps someone decide whether to read the table or skip it. Microsoft's alt text guidance notes that the Accessibility Checker does not flag tables without alt text, so this one is up to you.

  1. Right-click anywhere in the table and choose Table Properties.
  2. Select the Alt Text tab.
  3. Fill in Description, for example: "Opening hours for each branch, Monday to Sunday." For a complex table, also add a short Title.
  4. Select OK.

Microsoft's article on table properties describes the Alt Text tab. Alt text does not replace a proper header row, which is what lets a screen reader announce column names as the user moves through the cells. To mark it, click in the first row and choose Table Layout > Repeat Header Rows (or right-click, choose Table Properties, and on the Row tab tick Repeat as header row at the top of each page); Section508.gov's Word training on tables explains that this identifies the row to assistive technology. Then tick Table Design > Header Row so the style formats it. See the lesson on header rows that repeat and are announced.

Practise it: Mark a table header for screen readers (free).

Images of text: put the words in the document

A screenshot of an announcement, a quote designed as a graphic or a scanned form are all images of text. The UK government's guidance on publishing accessible documents says not to use images containing text, because the text cannot be resized. If you must keep the image, put the same words in the body of the document or, if they are short, in the alt text.

When to mark an image as decorative

Mark an image as decorative when removing it would lose no information: borders, divider lines, background textures, a stock photo used only for mood. Ticking Mark as decorative tells screen readers to skip it, which spares the listener from hearing "image" for something that adds nothing.

Microsoft's alt text guidance notes that images marked decorative are tagged as artifacts when you export to PDF, so screen readers skip them there too.

If you are not sure, ask whether a reader who could not see the image would miss anything. If they would, write alt text. The lesson on decorative images works through borderline cases.

Practise it: Mark a decorative divider as decorative (free).

Automatically generated alt text: check it before you keep it

Microsoft 365 can suggest alt text for pictures. In the Alt Text pane, select Generate a description for me (on Mac, Generate alt text for me). Word may also suggest text automatically when you insert a picture.

These suggestions describe what is visible, not why the image is in your document, and they can be wrong. Microsoft's guidance on automatic alt text is to review the text, edit it, and remove any extra notes such as comments about how confident the suggestion is. When it is right, tick Approve alt text if your version shows that option.

To stop Word generating alt text (the labels below are the ones in Microsoft's article; they can vary slightly between builds):

  • Windows: File > Options > Accessibility, then under Alt Text clear Enable the option to generate alt text using AI and select OK.
  • Mac: press Cmd+, to open Word's settings (called Preferences on older versions of macOS), select Accessibility, and clear Automatically generate alt text for me.

Common alt text mistakes

  • Leaving the file name in place. Some versions insert the file name automatically. Replace it.
  • Writing a caption instead of a description. "Figure 2" is a label, not a description.
  • Over-describing. Listing every person's clothing in a group photo slows the listener down without helping.
  • Putting data only in the image. If a chart is the only place a number appears, readers who cannot see it lose that number.
  • Giving decorative images long descriptions. Mark them decorative instead.
  • Forgetting shapes, icons and text boxes. They need alt text too, or the decorative tick.

Check your alt text with the Accessibility Checker

Run Review > Check Accessibility. Missing alt text is listed under Errors, and selecting an item takes you to the image so you can fix it from the Recommended Actions list. Microsoft's Rules for the Accessibility Checker list missing alt text as an error. The checker cannot judge whether your description is accurate or useful, so read your alt text back once with fresh eyes.

For a walkthrough of every checker message, see The Accessibility Checker in Word: How to Fix Every Warning.

Frequently Asked Questions

How long should alt text be?

Usually a sentence or two. Microsoft's guidance is that alt text should not be longer than that, and often a few words are enough. If you need more, put the extra detail in the body text or a caption.

Is alt text the same as a caption?

No. A caption is visible to everyone and usually labels or numbers the image ("Figure 3: Sales by region"). Alt text is read by assistive technology in place of the image. Many images need both, and Word can number captions for you with References > Insert Caption.

Does alt text carry over when I save as PDF?

Yes, when you save as PDF from Word with accessibility tags turned on, the alt text goes with the image, and images marked decorative are tagged as artifacts so screen readers skip them.

Do I need alt text on every image in a document?

Every image needs either alt text or the decorative tick. Choosing which one is the real decision.

Alt text is one item on the full accessible Word document checklist, alongside headings, tables, links and contrast. If you are placing images as well as describing them, How to Insert and Position Images in Word Without Breaking the Layout covers wrapping and positioning. For structured practice, the module on images, captions and alt text takes you through each skill on real documents.

Related posts

Written by Guccibase; see how these guides are written. Word Exercises is independent and not affiliated with Microsoft. Menu names follow Microsoft 365 as of 2026.