Skip to main content

Oregon State Flag An official website of the State of Oregon »

Oregon Health Authority logo

InDesign Accessibility Guide

Introduction

In this InDesign Accessibility Guide, we aim to equip Adobe InDesign users with knowledge on how to create and export documents for accessibility. We begin with the most pertinent information, how to properly generate a PDF, followed by a logical order of concepts for designing an accessible InDesign file. Remember, it is always easier to take steps towards accessibility while creating an InDesign document rather than relying on remediation solely outside of InDesign. If you follow the concepts in this guide to create a PDF, you’ll wind up with a tagged document that will be prepared for final remediation steps in PDF software like Adobe Acrobat. Visit the Web Content Accessibility Guidelines (WCAG 2.2) website to learn more about the most up-to-date accessibility criteria for websites and documents.

How to generate a PDF from an InDesign file

  1. If the PDF will primarily be used for web: File > Export; Format: Adobe PDF (Interactive); In Export to Interactive PDF dialog box: under General tab > Forms and Media, select Include All, Create Tagged PDF, and Use Structure for Tab Order; under Advanced tab > Display Title, select Document Title. Define Language. Click Export.
  2. If the PDF will be used for print and/or web: File > Export; Format: Adobe PDF (Print); In Export Adobe PDF dialog box: under General tab > Options, select Create Tagged PDF; under Include, select Bookmarks and Hyperlinks; under Include > Interactive Elements, select Include Appearance; under Advanced tab > Display Title, select Document Title. Define Language. Click Export.

Note 1: Never use File > Print to export: your exported PDF will not be tagged!

Note 2: When form fields are present, an Interactive PDF must be exported to preserve interactive functionality and accompanying accessibility features. Interactive PDFs may also be appropriate for use even when form fields are not present but use your best judgement to determine if PDFs designated for Print offer needed options (such as bleed affordances and high-resolution images) in circumstances where interactive form fields are not used.

Note 3: When form fields are present, certain assistive technology (such as screen readers) are unable to fill out interactive PDF forms in web browsers. Assistive tech users must download interactive PDF forms to their computer and open within a desktop application to fill them out. Check out this helpful article on opening PDF forms in web browsers from TPGi for more info.

Layout

Good design and accessibility are intertwined: Begin thinking about how you can make your layout accessible using the actual elements of design (Color, Form, Line, Shape, Space, Texture, Value, etc.) before you start utilizing built-in accessibility features of InDesign. Consider how people will interact with your document. Are you using Parent (or Master) pages for continuity? Is the document reading logically from left to right, top to bottom? Have you chosen legible fonts? Are you using plain language? By building a solid, straightforward structure, it will be easier to complete steps towards an accessible document as you continue working.

Scripts and Plugins

  1. If you are using accessibility scripts in InDesign, go to Window>Utilities>Scripts to open the Scripts panel.
  2. Right click on User folder and reveal in Finder or Explorer.
  3. Copy your scripts into that folder.
  4. To run scripts, you will double click them inside that folder.

Here are some useful scripts to install: 

Metadata Title

Documents need a clear, meaningful title so they can be correctly identified by all users, including assistive technology users.

  1. Add a meaningful document title within the metadata of your file. Go to File>File Info>Basic tab>Document Title. The title should be similar to or identical to the main H1 title that appears at the beginning of the document.
  2. Consider adding Author and Description information in the same place to further distinguish the document for assistive tech users. 
  3. When you export to PDF, be sure to open the Advanced tab, then select Document Title under Display Title; you should also set the language at this time.

Paragraph Styles

Using correct paragraph styles, and setting Export Tagging options, ensures that your document will export as a correctly tagged PDF. This is essential for many assistive technology uers, including screen reader users.

  1. Utilize paragraph and character styles for all text within your document.
  2. To define tags for each Paragraph style, select the Type tool, then select your desired text, then open Paragraph Styles. 
  3. Right click on the style, select Edit, then select Export Tagging on the bottom left. 
  4. At the bottom is the PDF tag – map the selected custom style to the correct PDF tag.
  5. Alternatively, you can go to Paragraph Styles, open the hamburger (panel) menu, and select Edit All Export Tags; then select the PDF button. Finally, map all your custom styles to PDF tags and click OK. Note: Bulleted and numbered lists need to be left as [Automatic] so they can be tagged correctly as lists.

Text Effects and Threading

Certain text effects can create problems for screen reader accessibility. For example, if you embed text by outlining it, those embedded portions of text often end up being tagged twice in PDF format. Try finding fonts that allow embedding (or you will have to add alt text to any outlined text, which is not ideal) and be careful with effects. We recommend occasionally checking your work with a screen reader as you go. Additionally, you may find threading text frames together in longer, text-heavy documents to be most beneficial.

Setting Tag Order

  1. Tag order is primarily defined by articles. Go to Windows > Articles to open the Articles panel.
  2. Grab an object with the Selection tool and drag it to the panel (you may be prompted to create an article, which you should do if there are no articles currently in the Articles panel).
  3. Continue dragging objects into the panel in the order you want to be read by screen readers. A new entry should be created under the last entry for each object you drag into the panel.
  4. Don’t include any decorative objects – this means that they will be artifacted and won’t have a tag.
  5. Go to the hamburger menu and make sure that Use for Tagging Order in Tagged PDF is selected.
  6. Alternatively, you can select multiple objects on a page at once by holding the Shift key as you click on objects in the order you want them to appear in the Articles panel. You can also rename and rearrange the articles in the Articles panel at any time, but this process must be repeated for every page in a document, and articles must be in the correct order before final export. 

New as of March 2025: Keith Gilbert of gilbertconsulting.com created a script called “create article from layer” which “creates an article that contains all the stories on the selected layer, in order from the first spread to the last spread, bottom item in the Layers panel to top item.” This is a great update that saves a lot of time. Learn more about this helpful Articles/Layers script from Adobe Certified Instructor, Chad Chelius, in his LinkedIn article from 03/26/2025.

Setting Reading Order

Some assistive technologies rely on a PDF's reading order, rather than tag order, to establish how the document will be displayed or read. Therefore, logical reading order must be maintained.

  1. Reading order is primarily defined at the page (or spread) level. If using spreads, you may need to change to single pages to give yourself more control.
  2. Open the Layers panel – note that this panel reads from bottom to top.
  3. Drag items up or down to move them into the correct order in the Layers panel. You may need to click the small blue square next to an item to identify it, this will make the square blue and will cause a visible frame to appear around the element.
  4. Note that items may need to be dragged out of nested groups to be in the correct reading order. Be careful not to accidentally nest items when setting the order. 

Anchoring Images

If you don’t anchor images, they can end up at the bottom of the tag structure. To anchor an image, use the Selection Tool to double-click on the image, then drag the blue square/anchor box to a text object you want to anchor it to and release. Try to choose the most appropriate place. Anchoring can cause text to wrap so you may have to get creative with where you anchor (anchoring to a heading rather than body text, for example) or get rid of containers to make anchoring work without disrupting your layout.

Alt Text for Images

Images need alt text so that all users, including blind and low-vision users, can understand them.

  1. Use the Selection Tool and select an image.
  2. Go to Object > Object Export Options > Alt Text tab.
  3. The default Alt Text Source setting is From Structure. Change the source to Custom. Add meaningful alt text in the text field (assuming there is none present, or the alt text provided is not meaningful).
  4. You might also be able to take metadata text from the image to use as alt text. Do this by making a selection from the Alt Text Source options (such as From XMP: Description). Verify that alt text created from metadata is meaningful and complete.

Tagged Captions

  1. You sometimes need caption tags for descriptions of images, tables and other elements. Note that captions aren’t offered as an export option.
  2. To create a caption, go to Object > Captions > Caption Setup. 
  3. Under Metadata drop down list, select Headline. Leave Alignment set to Below Image. Under Paragraph Style select the desired style for your captions. You may also want to tinker with the offset for your captions.
  4. Delete the existing text field with the caption, if one exists.
  5. Select the image; go to Object > Captions > Generate Live Caption.
  6. You can apply a text wrap if you need further control of the caption layout.
  7. Note that there is a limitation to this approach: when captions stretch over two more lines, text will be condensed and unreadable (this is a design flaw in InDesign).
  8. Another approach is to name the Paragraph style for text captions “Caption”; later in the PDF, you can select Edit Role Map under Options, find the mapping for Caption to <P>, then delete that line. The result should be a correctly mapped <Caption> tag.

Artifacting Decorative Objects

Images and other objects that are purely decorative should be "artifacted" so that assistive technology will ignore them.

  1. Select the graphic/image and go to Object > Object Export Options.
  2. Ensure that the Alt Text source is set to From Structure.
  3. Click Tagged PDF button.
  4. Under Apply Tag, select Artifact.
  5. Click Done.
  6. You can also artifact an object by not including it when creating the tag order in the Articles panel.

Lists

Lists need correct semantic structure so that they will be read correctly by assistive technology.

  1. Note: Avoid the “Indent to here” command when creating bulleted lists
  2. Select the text using the text selection tool
  3. Select the Paragraph Formatting Controls button (it looks like a Paragraph symbol) in the top menu
  4. Select the button for Bulleted List or Numbered List 
  5. Hold Alt and press the Bulleted List or Numbered List button again to bring up the Bullets and Numbering Options dialog. Here you can adjust the indents for your bullet or number. 
  6. It’s a good idea to create a paragraph style for your list, so that you can apply that style to future lists
  7. If you run into the classic problem of having too much space between list items, right click on the paragraph style you created and select edit; in the Options box, set Space Between Paragraphs Using the Same Style to 0.

Links

Links need to be created correctly so that the assistive technology users can interact with them appropriately.

  1. Open the Hyperlinks panel by going to Window > Interactive > Hyperlinks.
  2. Use the Type Tool and highlight the link text. 
  3. Click the plus sign button in the Hyperlinks panel to create a new hyperlink. If the hyperlink has already been created, you can click on the hamburger menu and then click Edit Hyperlink.
  4. Set the Destination to the correct setting - if the link goes to an URL, set it to URL; if it goes to an email address, set it to email, etc.
  5. Turn off the Shared Hyperlink Destinations option unless you have multiple links to the same destination in your document as it can create problems if you don’t turn it off.
  6. Leave the style as Hyperlink.
  7. Click on the Accessibility tab and add alternate (annotation) text: this should be the title of the webpage that is the destination. If you don’t do this, it will get flagged as an error when you convert to PDF.
  8. Check to make sure that your hyperlink style has enough color contrast against the page background color in all instances that it occurs (it will probably need to be at least 4.5 to 1 to meet WCAG AA standard). Adjust this by going to Character Styles>Hyperlink and changing the color for all hyperlinks there.
  9. In documents that are going to be read partially in printed form, it is most appropriate to leave text as URLs. If URLs are excessively long, consider using bitly, or another link shortening service, to reduce the size of the URL.

Tables

Tables need correct semantic structure so that they will be read correctly by assistive technology.

  1. Tables should only be used for data. Layout tables are not converted correctly in a PDF and will have to be repaired later, so avoid them when at all possible, especially complex tables.
  2. Ensure that tables have correctly designated column headers. With the Type Tool, highlight the header row or rows. Go to Table > Convert Rows > To Header. 
  3. This may change the formatting of the header row (depending on whether you have preexisting table styles applied). You can alter this under Table Styles. Note, however, that headers should be visually distinct.
  4. Column headers can be designated in InDesign, but InDesign will not allow you to designate row headers. InDesign will also not define scope for table cells. These properties will have to be set in Adobe Acrobat and/or CommonLook after conversion to PDF.
  5. Also note that you may have to remove Tables from <P> tags in your PDF after conversion (this will be flagged as an error unless you fix it in the tag tree). You may also have to artifact table footers (and redundant header rows for tables that span pages) if they were created in your table style. 
  6. Notably, InDesign (in contrast to Microsoft Word) handles merged cells well.

Cross-References in a Document

  1. Check the paragraph style for the target item before you begin.
  2. Select the cross-reference text and delete it. 
  3. Go to Type and Tables>Cross References.
  4. Click the plus sign (Create New Cross References) button.
  5. Under Paragraph Styles, select the paragraph style for the target item.
  6. Under Paragraph Text, scroll through the options until you find the one you want your cross reference to link to.
  7. Click on that item in Paragraph Text.
  8. Under Cross-Reference Format, click the edit (pen) button.
  9. Name your new Cross-Reference Format.
  10. Double click on the Cross-Reference Format to edit it. Add words or delete spaces in the Definition field as needed.

Table of Contents

  1. Create a new text frame/story for your TOC.
  2. Go to Layout>Table of Contents.
  3. Create a Title (“Table of Contents,” or “Contents”).
  4. Select a Style (you will need to have created this already).
  5. Under Other Styles, choose the heading styles that you want to be entries in your TOC. Click Add to add each one.
  6. They choose an Entry Style for each subheading (again, you’ll need to have created this already).
  7. Decide where you want the page number to appear and select this option.
  8. Select the option that want for Between Entry and Number (the recommended option is Tab Character).
  9. You’ll need to select a style for each of your subheadings.
  10. Make sure Create PDF Bookmarks is selected under Options.
  11. Click Save Style and give your style a name. Click OK.
  12. Click OK again in the Table of Contents dialog box.
  13. Your cursor will load with the TOC. Click in your text frame to place it there.

Indexes

  1. Go to Window>Type and Tables>Index. This opens the Index Panel.
  2. Select text and use the plus button to create a new entry.
  3. When your index entries are complete, create a new page at the end for your index.
  4. Go to the hamburger menu in the Index Panel and select Generate Index. You can apply a style in the dialog box. 
  5. Click OK to load your cursor. Then click the page to place your Index.
  6. Note that the Index should export as list items.

Adding PDF Bookmarks

  1. Go to Window > Interactive > Bookmarks.
  2. If you selected the option for Create Bookmarks in your TOC Options, you will already have bookmarks here. If not, you’ll need to create them.
  3. To create a new bookmark, in the Bookmarks pane, use the Create New Bookmark button (or plus sign). A new bookmark will be created based on the page that is currently selected. Create a bookmark for each major section of your document.

Footnotes and Endnotes

  1. Go to Type > Document Footnote Options.
  2. Under Numbering and Formatting, apply a Character Style if desired.
  3. For Footnote Formatting, apply a Paragraph Style (you’ll need to create this if you want it to differ from other paragraph styles).
  4. Choose your separator (this can be a Tab).
  5. Insert your cursor where you want the footnote; go to Type > Insert Footnote, then type the text you want in your footnote.
  6. The process for creating Endnotes is very similar, but we need to choose Document Endnote Options under Type, and then choose the desired styling options. You’ll use Scope to decide where the Endnotes go (you probably want them at the end of your document).
  7. Note that there is currently a bug with Endnote creation in InDesign. You may need to drag the text object into the Link tag after converting to PDF.

Form Fields

Form fields must be created correctly so that all users, including assistive technology users, can interact with them appropriately.

Note: when creating form fields for fillable forms, avoid overlapping text boxes with one another or with shapes used to create the fillable text areas. Overlapping of frames and shapes can create accessibility problems when exporting to PDF.

Text Fields 

Create text fields using your preferred methods and use the steps below to ensure accessibility:

  1. Create a frame (unassigned frames work well).
  2. In the Buttons and Forms pane (Window > Buttons and Forms) set Type to Text Field.
  3. Give your field a Name (for example, “First Name”). It’s important that the Name be meaningful, because you will need to be able to identify the fields in the Tab order using the name created here. However, the Name is only used for reference purposes by the document creator. It won't be read to screen reader users or other assistive technology users using your published form.
  4. Fill in the Description field with clear instructions for people filling out this form field. For example, "Enter the name of your school or program." The text you enter under Description will generate a tooltip that will be visible to sighted mouse users when hovering over that form field. This text will also be read to a screen reader user when they navigate to that form field. It's best practice to have the description incorporate the visual label for the form field, but for it to be slightly more informative. This can help screen reader users identify the form field as distinct from the text label. Also note that it is best practice to include any additional information relevant to the form field in the Description. For example, if there are multiple labels that apply to a field (as sometimes happens in complex forms) they should all be included in the Description. In addition, if the field is required, this information should be included in the Description.

Check boxes

Answer sets where more than one answer is permitted should be structured as check boxes, not radio buttons.
  1. Create one or multiple square shapes using the Rectangle Tool.
  2. Select a square and go to Window > Interactive > Buttons and Forms.
  3. In Buttons and Forms pane, select Check box from the Type dropdown.
  4. When creating a set of check boxes, ensure that each individual check box has a different name; for example "Check box 1," "Check box 2." This may seem counter-intuitive; however, if you use the same name for multiple check boxes, they will behave as mutually exclusive choices, which is not correct behavior for check boxes.
  5. In the Event dropdown, select On Release or Tap.
  6. In the Description field, enter the label for the check box group followed by the label for the individual check box. Again, this may seem counter-intuitive. However, Button Values will not be consistently read by screen readers; therefore, the information for each individual check box needs to be added to the Description of that check box.
  7. When you select Check Box as the Type of form field, a Button Value field will appear. Enter the unique label for each individual check box in its Button Value field (For example, "English" or "Spanish"). Again, this information will not be read to screen reader users, but it still must be added for the check box to function appropriately.

Radio Buttons

Mutually exclusive answer sets (for example, Yes / No choices) should be structured as radio button sets, not check boxes.
  1. Create two or more circular shapes using the Elliptical Tool.
  2. Select all the shapes at the same time using Shift + click.
  3. Go to Window > Interactive > Buttons and Forms.
  4. In Buttons and Forms pane, select Radio button from the Type dropdown.
  5. Give all radio buttons that are part of the same group the same Name under the Name dropdown; for example, "Button Group 1." This name will only be visible to the document creator, it will not be read by a screen reader. However, using the same name for all grouped radio buttons ensures that the radio buttons will be treated as mutually exclusive and will be correctly interpreted by assistive technology.
  6. In the Event dropdown, select On Release or Tap.
  7. Expand PDF options within Buttons and Forms panel. Under Description, type in a description that includes the question or label relating to the group of radio buttons (i.e. if the text label reads "What is your preferred language?" that should be the Description). The Description should be the same for all radio buttons in a group of buttons.
  8. Select the first radio button in the set. Under Button Value, enter the individual radio button label.
  9. Select the next radio button in the set and enter a Button Value.
  10. Continue this process until all the radio buttons in the set have distinct and accurate Button Values

Form Fields in Tables

Having form fields within a table is an example of a complicated layout table, which we recommend avoiding. If you must use a form field within a table or find yourself remediating one, here are steps you can take to make them accessible. It is acceptable to create form fields inside a table structure. Avoid irregular tables when doing this – remediating the resulting structure in PDF will be a nightmare! If your table has already been created, you can use the following approach to ensure that the resulting form will be organized correctly when you convert to PDF.

  1. Select all the cells in your table. 
  2. Choose Window >Type and Tables > Table. Set Row Height to Exactly (second box down on the left). Then set all your insets to 0 (last four boxes down on the left).
  3. Click inside a cell with the black arrow tool and press escape to highlight the whole cell. 
  4. Choose Table>Convert Cell to Graphic Cell to make the cell a frame.
  5. Under Buttons and Forms change the cell Type to Text Field.
  6. Select the text field and cut it (CTRL + X). Then paste the text field back into the frame (CTRL + V). This will ensure that the form fields are correctly nested inside your table structure when you convert to PDF.

Defining Tab Order for Form Fields

  1. Go to Object > Interactive > Set Tab Order.
  2. In the Tab Order box, use the Move Up and Move Down buttons to adjust order (if needed). Note that the order can be read from top-to-bottom (as opposed to bottom-to-top when setting Reading Order).
  3. Click Ok when the desired Tab Order is reached.
Remember: When exporting a form, it is crucial to use the Adobe PDF (Interactive) option.