David Berman Communications
David Berman will help you repeat your successes

How To: Alternative Text for Decorative Images in any version of Microsoft Office

Posted on

Update November 2020: We’re very pleased to report that the latest releases of Office 365 have substantially improved the Decorative checkbox, and that it now works effectively both with screen readers working with Office files, as well as PDF files exported from Word. There are still imperfections; however, we have test results from all major screen reader combinations demonstrating that, for the most part, one can now trust the Decorative checkbox to behave as expected. Therefore, although our recipe contains many nuances that are invaluable to users of earlier versions of Office, the best advice we now can offer is to upgrade to the latest version. Thank you, Microsoft, for listening carefully, and continuing to work with us and others in the community to strive to include everyone.


We’re constantly striving to create accessibility techniques that are so easy to do that everyone who creates documents can make them a habit. Today’s tip is about decorative images in Microsoft Office: whether Word or PowerPoint.

If you’re familiar with creating accessible documents and webpages, then you already know the importance of using alt attributes for images in HTML, including making the attribute blank (<alt=””>) for those images that are decorative, redundant, or irrelevant. Similarly, in PDF files, we mark such images as an “artifact”.

However, one of the big challenges in creating accessible PDF files from Microsoft Office is the unfortunate lack of a way within Word and PowerPoint to indicate that an image is irrelevant. Hopefully, Microsoft will soon realize how important this is, and give us an Artifact checkbox in the Alt Text tab. (Yes, Microsoft has added a Decorative checkbox in Office 365 and Office 2019, but it still, sadly doesn’t do what we need it to do!)

Read the full recipe…


(Microsoft certainly has been making strides to make it easier to provide alternative text. The Insider Release of Word 365 now includes an Edit Alt Text command that optionally gets you directly to the Alt Text field. And their artificial intelligence engine that now proposes alternative text based on image analysis is quite remarkable: however, this also underscores the need to effectively label decorative images when the AI engine is proposing the inclusion of a description for an image that is actually decorative.)

In addition, you may wish to publish an accessible .docx or .pptx file as is (rather than exporting it to another format such as PDF or HTML)… or have people living with disabilities help author those files. And so we need consensus on how to indicate decorative objects within these situations as well.

To draw a parallel, Adobe InDesign users have the ability to add an Artifact tag to images within InDesign (using the Object Export Options feature) so that when they export to PDF, the resulting file has the image artifacted. However, Office doesn’t have such a feature … and so you have no choice but to manually fix each such image in the resulting PDF file (for example, using Acrobat Pro’s Decorative checkbox in its Set Alternate Text feature). Even worse, if you make changes to the Word or PowerPoint file and generate a fresh PDF file, you have to repeat that manual work over again each time. Until now.

We researched and we consulted with many other accessibility experts. We also looked carefully at what Microsoft suggests. But we were still unsatisfied. So we ran tests with various versions and platforms of Office and Acrobat Pro, as well as with various assistive technologies and testing with people living with disabilities.

The result is that we’ve come up with what we think is the best practice for getting accessible PDF files from Word and PowerPoint in a way that yields the best output, and is also the most sustainable and realistic workflow (including playing well with the Office Accessibility Checker built into Microsoft Office). Our technique works whether you are generating PDF or whether you’ll be sharing documents as accessible pptx or docx.

A very common solution to this issue, that I feel strongly should be discarded, is to put a wordspace (or a non‑breaking space or an en dash or an em dash…) into the Description field of decorative images in your .docx and .pptx files. However, not only will the Office Accessibility Checker mark these as errors (making it impractical to track which images you have set correct alternative text for and which you have not) … but also (although Acrobat Pro’s Accessibility Checker will not complain) your resulting PDF will now have figures with Alt text dysfunctionally containing a single wordspace. Those figures in your PDF file will sadly announce with phrases such as “Graphic 16” in the JAWS screen reader. Such figures will also understandably fail the PDF/UA standard, with the PAC 2.0 checker reporting an error of “Missing Alternative Text”.

So, instead, here’s our better recipe:

  1. In Word or PowerPoint, go to the Description field in Format Picture or Format Graphic (or the Alternative Text field in Word 2003 or 2007) which would normally hold your alternative text, and put just the word “Decorative” (“Décoratif” or “Esthétique“ in French). (Tip: You can highlight multiple objects and apply the same Description to them all at once.)
  2. If you have any groups of objects, set the Alt Text for all Group elements to “Decorative”, whether the elements within the Group are decorative or not. Conveniently, such Group objects will be automatically coded accessibly in the resulting PDF. (Tip: If you are in a PowerPoint file, add decorative objects on Master slides where possible. Once exported to PDF, such images will already conveniently be artifacts, i.e. “background”).
  3. When you run the Office Accessibility Checker, you’ll find that, conveniently, the objects you’ve marked as “Decorative” will no longer appear as Errors, allowing you to easily find those objects that still need attention. (The Office Accessibility Checker gives an error for “Missing Alt Text” on objects whose Description field is empty or contains only blanks or a URL).
  4. If exporting to PDF, export the file using our standard best practice recipe for exporting Word or PowerPoint to PDF:
    1. Acrobat ribbon> Preferences> Settings tab: check the Enable Accessibility And Reflow With Tagged PDF checkbox.
    2. Acrobat ribbon> Preferences> Settings tab: check the Enable Advanced Tagging checkbox. (In Word 2010, this setting is instead on the Word tab.)
    3. Advanced Settings button> Fonts section> check the Subset Embedded Fonts When Percent… checkbox, then set its value to 1% … then remove all fonts from the Never Embed list.
    4. Acrobat ribbon> Create PDF. (If the file includes Type 1 fonts, you may have to Save As PDF instead.)
    5. Acrobat Pro> Tools> Action Wizard> Make Accessible Wizard> run “Set Open Options” and run “Set Tab Order Property”.
  5. In Acrobat Pro (or the PDF editing tool of your choice), artifact every “Decorative” object using the Touch Up Reading Order tool, finding then selecting each as a “Background”.  (Warning: You’ll be tempted to use the Acrobat Pro Set Alternative Text’s “Decorative” checkbox feature to change the “Decorative objects from your Office file into artifacts. However, sadly, that feature will not do a proper job of artifacting these objects. Instead use the Touch Up Reading Order tool to locate each one that shows as “Decorative, and then select the Background button to artifact … or use other advanced techniques or tools.)
  6. If exporting to HTML instead of PDF, then, in the resulting HTML, search and replace Alt=“Decorative” to Alt=“”.

So there you are. Do you agree or would like to give me some pushback? And would anyone like to propose what the standard term for “Decorative” should be in languages other than English or French?

Thank you to all the experts and testers who helped us sort this out!

(Also, if you don’t already have our Accessibility Ribbon for Word, you may wish to try it out!)

Accessibly yours,
David Berman, CPWA, CPACC, WAC

Would such tips help others? Subscribe at davidberman.com/subscribe.

More Accessibility Recipes

Return to top

Reviewed November 1, 2020

6 Responses to “How To: Alternative Text for Decorative Images in any version of Microsoft Office”

  1. Renee M Nowak says:

    Hello, Is there a way in Word to mark a borderline as decorative? Our section pages of our documents include a thick, blue color border line between the Section # and Title of the Section. If it was a shape, I know how to mark it as decorative but since it’s not, I’m not so sure if it could be done.

    • David Berman says:

      Hi, yes this is solvable. A horizontal line between the text (or a border line on any image) is not considered a figure in Word (nor a figure in PDF if exported using our best-practice no-tradeoff recipe for exporting from Word to PDF). Hence, there is no need to add alternative text (which is why you won’t find an “Edit Alt Text” command available in Word in such a situation. Note: There is a known bug in the current version of JAWS where a horizontal rule in a .docx (or .dotx) can wrongly announce as “blank”: JAWS support has confirmed this, and they don’t have a release date yet for a fix … however such a bug doesn’t mean that your file is not technically accessible.

  2. Stephan says:

    Hi David,
    Your remark about the Decorative checkbox in Office 365… I tried a document with Office 365 and noted that images marked as Decorative became artifacts in the PDF (version 1.7).
    Regards, Stephan

    • David Berman says:

      Hi Stephan,
      You are correct: Microsoft has been improving this feature this year, and it is now true that the Decorative checkbox in the most recent releases of Office 365 do indeed pleasingly result in Office files exported to PDF correctly showing such images as artifacts in the PDF file. We are updating our recipe to share that good news!
      Regards,
      David

  3. Kayla says:

    Hello, do you have any recommendations for making Microsoft Publisher documents accessible? Specifically how to use the Alt Text tab in Publisher.
    Thank you

    • David Berman says:

      Hi Kayla,
      Thank you for reaching out.
      We have indeed researched accessibility for Microsoft Publisher.
      Unfortunately, the inconvenient truth is that there is no support for accessibility in Microsoft Publisher to speak of, including no way to add Alt Text.
      So, the best path is to export to PDF and then manually fix the PDF to make it accessible (which you can do yourself, or we can do for you).
      Regards,
      David


Reply to David Berman