Set up your File up for Success
The first step is setting the overall context and structure of your Google Doc. This critical step gives your document it’s identity so users know what to expect when they open the document and navigate through the content.
This includes:
- Adding a descriptive document title
- Verifying the document language
- Reviewing the page setup
1. Add Document Title
Set a unique, meaningful file name that clearly describes the content and purpose of the document.
Use a descriptive file name. Not only does this help you quickly identify the document, it helps your readers quickly understand the purpose.
- Good Example: Annual Report 2024 Summary
- Avoid: Untitled Document or Draft 3
Add the Document Title
- Locate the current title: This is typically displayed at the very top of the Google Docs interface, usually centered or slightly to the left, above the main menu bar (File, Edit, View, etc.).
- Click to edit: Simply click on the current title (which might be the generic “Untitled document,” or a previous name).
- Type the new title: Type in the unique, meaningful name (like Annual Report 2024 Summary).
- Save: The title is automatically saved as you type and click away, or by simply pressing Enter.
2. Set the language
Setting the document’s language is to ensure accurate pronunciation by screen readers and other assistive technologies.
If the language is set incorrectly (for example, the document is in Spanish, but the language setting is left as English), a screen reader will attempt to read the Spanish words using English phonetics and pronunciation rules.
This results in the audio being completely garbled and unintelligible for the user. Setting the language tag correctly ensures the screen reader uses the appropriate voice and linguistic rules to deliver clear, accurate content.
Set document language
By default, your Google Doc language may be set to English. If you need to adjust this at all follow these steps:
- Go to File
- Select Language
- Verify current language is correct or change language by selecting the appropriate one from the list
3. Review Page Setup
It’s a good idea to review the page layout settings at the beginning of your project. This will allow you to adjust page margins and the orientation before any content is added. This helps ensure a consistent look for ther final document.
Access Page Setup
- Go to File
- Select Page Setup
- Adjust the orientation, paper size, color, and margins as needed
- Select whether you are viewing as pages, or pageless
- When you are done, select OK
Build a Solid Foundation
The structure of your document is the most critical factor for screen reader users.
Building a solid foundation in your document not only benefits your readers, it also cuts down on the time needed to fix issues later.
Build structure into the document by:
- Using heading styles
- Adding lists
- Paying attention to paragraphs
1. Use Heading Styles
Headings are the foundation of the document.
Just as a foundation creates a solid frame to build to build a house on, properly used headings create a navigable, hierarchical structure for your document.
Without this strong foundation, the document is just a pile of materials, making it impossible for screen readers to “walk through” the content efficiently.
Tips for headings
- Only use a single Heading 1 (typically the main document title)
- Maintain strict hierarchy: always follow H1 with H2, H2 with H3, and so on. Do not skip levels (e.g., jump from H2 straight to H4).
- To apply a heading style, select the text, navigate to the Styles dropdown menu (usually set to ‘Normal Text’), and select the appropriate heading level (e.g., Heading 2) from the list.
- Use the built-in styles palette exclusively for creating your document structure. Never use manual formatting (bold, increased font size) to make content look like headings.
- If you make adjustments to a heading’s visual style, highlight the text and from the Styles dropdown menu select “Update [ heading #] to match.” This will apply your new visual style to every instance of the document
- Bonus! If you use headings consistently through the document, you can quickly add table of contents to your document.
2. Add lists
Lists help break up lengthy content and present it in an organized way.
Use the built-in Bulleted List (for items where order doesn’t matter, like ingredients) and Numbered List (for steps or ranked items, where order is critical) tools for all lists.
Misusing lists for general paragraph formatting breaks this semantic structure and can lead to a confusing experience for some users.
Tips for lists
- Never use asterisks, hyphens, or manual numbers. Screen readers will correctly announce the number of items and the type of list, providing valuable context.
- Nested lists are accessible only if created using the Tab key or the Increase Indent button to move sub-items to the next level.
- Caution! Limit nested lists to two or three levels maximum, as excessive depth can significantly increase cognitive load and navigational difficulty.
- A list is two or more items. Never create a list for a single item.
3. Pay Attention to Paragraphs
The paragraph style makes up the bulk of your document. Here are some tips to ensure your paragraphs improve the reader experience.
Tips for paragraphs
- Alignment: Keep the default alignment (Left Alignment). Avoid Justified Alignment as it creates inconsistent white space (“rivers”) that is difficult for users with dyslexia or cognitive disabilities to track.
- Avoid Manual Spacing: Never use the spacebar, multiple tabs, or the Enter key multiple times to force white space, indentation, or page breaks. This creates structural chaos for screen readers. Instead, use the Increase Indent tool or Tab Stops for precise indentation, and Insert > Break > Page break to move content to the next page.
- Line and Paragraph Spacing: Use adequate line spacing (1.5 lines minimum is recommended) and space after paragraphs to visually separate blocks of text, improving readability for many users. Need more precise control? Use the Line and Paragraph Spacing tool!
- Chunk lengthy paragraphs: Break large blocks of text into smaller, digestible paragraphs (“chunking”) to improve reading flow.
Describe Visual Elements (Images, drawings, charts, equations, colors, and hyperlinks)
All non-text content and visual design choices must be made accessible to users who cannot see them clearly. This means:
- Describing informative images and graphics with alternative text
- Marking decorative images as artifacts
- Describing charts, drawings, equations and any other data visualizations
- Checking for accessible color contrasts
- Inserting descriptive hyperlinks
1. Describe Images and Graphics
Informative images are images that convey essential data, context, or meaning. These require an accurate, descriptive Alternative Text (Alt Text) that explains the image’s purpose or content.
Add Alt text to Informative Images
Using native Google Docs Tools:
- Select the Image: Click once on the image you want to provide Alt Text for.
- Access Image Options: Right click the image to access the image options and select Alt Text or select Format, Image, Image Options.
- From image options, locate the Alt Text dropdown menu
- Enter Text: A dedicated field will open, allowing you to enter the descriptive Alt Text.
Using the Grackle Docs Add-on
- Go to Extensions, Grackle Docs, Launch.
- Navigate to Images: In the Grackle report sidebar, click on the Images section.
- Locate & Tag: The report lists images needing review. For each image, you can click: Locate to jump to the image in the sheet. +Tag to open the tagging window.
- Provide Alt Text: In the tagging window, you can enter the Alternative Text description
2. Mark Decorative Images as Artifacts
Purely decorative images are images serve only an aesthetic purpose and add no informational value, such as a company logo or border art.
Use the Grackle Docs tool to mark the image as an Artifact so screen readers ignore it.
Mark decorative images as artifacts
- Go to Extensions, Grackle Docs, Launch.
- Navigate to Images: Click on the Images section in the Grackle report sidebar.
- Tag the Image: Locate the decorative image in the list and click the +Tag button.
- Mark as Artifact: In the tagging window, select the Mark as artifact option to tell screen readers to skip this image.
Note: If an image is marked as an artifact, it is completely hidden from assistive technology. Only do this if the image is indeed purely decorative.
3. Describe Drawings, Charts, and Equations
Just about any visual element you “Insert” into the document needs to have a description as well. This includes things like drawings, charts, and equations.
Drawings
To add a drawing to the document:
- Select Insert then Drawing
- Select +New or From Drive
- Once the drawing is added to the document, select the drawing then go to Format, Image, Image Options
- From image options, locate the Alt Text dropdown menu
- Enter Text: A dedicated field will open, allowing you to enter the descriptive Alt Text.
- Caution! Ensure all colors in your drawing have good contrast and are easy to read. If your drawing contains text, add the text to the alt text field as well.
Charts
Charts can be linked from another source like Grackle Sheets. Follow all guidelines for making the chart accessible in the original linked source. Visit Google Sheets: Describe Visual Elements for more tips.
To add charts to the document:
- Select Insert then Chart
- Select the Chart Type or From Sheets
- If you select a chart type, you will have to edit the chart in Sheets by selecting the chart, chart options, then open source. If you select From Sheets, you will select a sheet that already exists.
- Select the Chart: Click once on the chart you want to provide Alt Text for.
- Access Image Options: Right click the chart to access the image options and select Alt Text or select Format, Image, Image Options.
- From image options, locate the Alt Text dropdown menu
- Enter Text: A dedicated field will open, allowing you to enter the descriptive Alt Text.
Equations
Insert mathematical equations using the built-in Equation tool (Insert > Equation). For complex equations, ensure the resulting image/object has accurate Alternative Text that describes the equation’s purpose or reads the equation aloud, as screen readers may not interpret the formulaic output correctly without it.
- Select Insert, Symbols, then Equations
- Use the New Equation tools that appear after the toolbar (menu, undo, redo, print, etc.) to write your equation. Options include Greek letters, miscellaneous operations, relations, math operations, and arrows
- By default, the equation may be added to the alt text of the equation editor. To view or adjust this description, you must run Grackle Docs
- Select Extensions, Launch, Grackle Docs
- In the Images section of the report, locate the check Equations should be described
- Select +TAG to review the current alternative text description
- Edit as necessary and select Update
- Repeat for every equation in the document
4. High Color Contrast
All text must be easily distinguishable from the background color. This applies to text in the sheet and the text within images, charts, or graphics.
Text High Color Contrast
Use the Grackle Docs extension to identify and fix any instances of low contrast.
To check for contrast:
- Select Extensions, Grackle Docs, Launch,
- Open the Contents section
- Review the check High Color Contrast Colors should be used.
- Select Locate to identify the area of concern
- Adjust colors as needed
Image High Color Contrast
Since Grackle Docs only flags color in text, use a color contrast tool like the one available from TPGi to verify the accessibility of the colors in your images, graphics, and charts. Adjust colors as needed.
5. Insert Descriptive Hyperlinks
Ensure the link text is informative and descriptive, making sense out of context. Avoid link text like “Click Here,” “Read More,” or “Link.”
Inserting hyperlinks
To add hyperlinks to the document use one of the following methods:
- Place your cursor where you want to add a hyperlink the select Insert, Link. Add the descriptive link text and the hyperlink.
- Type the descriptive link in the document, highlight the text and right-click, select Insert Link from the list of options and add the hyperlink.
Check Data Tables
Tables should only be used to organize data, and not for content layout. Ensure tables are accessible by:
- Understanding the difference between Layout and Data
- Keeping things simple
- Adding header tags
Understand Layout vs Data Tables
Tables used purely for visual layout create confusion for screen readers, as the logical reading order is broken.
If you need two or three columns of non-tabular text (e.g., a newsletter or sidebar text), use the Columns feature instead of a table.
Add Columns
To add columns to a section of text:
- Highlight the text you want in columns
- Select Format, Columns
- Select the number of columns you want or select More Options and select the number of columns, spacing, line between columns, and column order
- To add a column break, place your cursor where you want to add a break, select Insert, Break, Column
Keep things Simple
Keep tables simple. Avoid complex nesting, merged cells, or split cells, as these confuse screen readers.
Use the Google Docs Table Options tools to add visual elements to make data more readable, pin header rows, and keep data from breaking across pages.
Open Table Options
Table options are a powerful tool to format the visual style of your table. To access these options use one of the following methods:
- Right-click the table and select Table Options from the list
- Select the table then select Format, Table, Table Options
- Select the table then select the the More button on the toolbar (three dots on the right-hand side of the toolbar) and select Table Options
- Within table options you have access to quick layouts, table settings, column, row, and cell settings, and color options
Pin header rows
Pinning a header row does not make a table accessible, but it can make the content easier to follow visually it the data breaks across pages. To pin the header row:
- Open the Table Options
- Select the Row dropdown
- Select Pin header row and if applicable, the number of rows
Allow row to overflow across pages
If you have data or content in the table that may span across pages, you can select to keep the content within the same page. This is helpful visually for keeping content together.
- Select the data you want to stay together and not break across a page (this can be a single row or the entire table)
- Open Table Options
- Select the Row drop down
- Unselect Allow row to overflow across pages
Add Header Tags (Critical!)
Google Docs does not have a native tool to semantically tag header cells for screen readers. After completing the table structure, you MUST use Grackle Docs to properly designate the first row (or column) as the header row. This is a critical step for accessibility.
Add Header tags with Grackle
The formatting tools in Google Docs can help with the visual presentation of the table, but to add programmatic headers to assist screen reader users, you MUST use Grackle Docs.
- Launch Grackle Docs
- Select Tables must be tagged or marked as layout tables
- Select the Locate button to locate the table
- Select the +Tag button to open the Tag Table options
- Update the options to define the purpose and structure of the table in your document.
- Select Table is used for layout only if the table is purely decorative. When checked, it tells assistive technologies to ignore the table’s structure.
- Select Mark first row as header for tables that contain data and use the top row to label the content of each column.
- Select Mark first column as header for tables that use the first column to label the content of each row.
- Select Associate with column headers and Associate with row headers to further define the table settings and help assistive technologies, like screen readers, understand the relationship between a data cell and its corresponding header cell in a table.
- Use Mark as header cell for Column, Row, or Both to further define complex data tables.
- Update and repeat as needed
Make it Readable and Legible
Ensure your sheet is easy for everyone to read by:
- Using a clear, readable fonts
- Avoiding fine print
- Avoiding color as the only way to convey meaning
1. Use clear, readable fonts
Use fonts that have consistent spacing, distinct characters, and do not use overly decorative or stylized strokes.
For digital resources like Google Docs this means opting for well-designed sans-serif fonts (those without the small decorative lines, or serifs, at the end of strokes), as they are often easier to read on screens.
Fonts to avoid include:
- Decorative or Handwriting style fonts
- Highly condensed fonts
- Thin fonts
2. Avoid Fine Print
Set all body text to 12-point or larger for optimal readability on all devices, especially for users with low vision or cognitive disabilities.
Avoid using anything smaller as it is more difficult for users to read on a screen.
3. Avoid Color to Convey Meaning
Never use color alone to convey meaning (e.g., “Cells marked red are critical”).
Use clear text labels, symbols, or notes in addition to color to convey meaning. This will ensure all users can read and understand the content presented in your sheet.
Add Navigational Items
These elements provide consistent orientation and rapid navigation for all users. Add navigational items by:
- Inserting a Table of Contents
- Adding footnotes
- Formatting headers and footers
- Adding page numbers
Insert Table of Contents
If the document has headings then you can insert an automatic Table of Contents based on the heading structure.
Insert Table of Contents
To insert a table of contents to the document:
- Place the cursor where you want the Table of Contents to go
- Select Insert, Page Elements, Table of Contents
- Select the style you want for your Table of Contents (plain text, dotted, or links)
- As you edit your document, select the Update button to refresh the table
- Select the More Table of Contents Options button to access additional formatting and heading level options
Add Footnotes
Use the built-in Footnote tool for all citations and references. This correctly tags the note, allowing screen readers to announce the note and navigate the user to the reference location.
Insert Footnotes
- Place the cursor in the document where the footnote needs to go
- Select Insert
- Select Page Elements
- Select Footnote
- Add the footnote reference information in the footer
- Repeat as needed
Format Header and Footer
Use headers and footers for consistent, repeating information like document titles, dates, or page numbers. Note: Content in the header and footer area is typically not read by screen readers.
Insert and Format Header
The page header typically includes the document title, author and / or date information. May also include page numbers, confidentiality, or version information, but this is more common in the footer.
To add headers to your document:
- Select Insert
- Select Page Elements
- Select Header
- Add content as needed, for example type the document title, author name, or date information
- Select Options to access the Format Header menu to adjust margins or layout
Insert and Format Footer
The page footer typically includes page numbers, confidentiality or version information. May also include title, author or date information but this is more common in the header.
To add footers to your document:
- Select Insert
- Select Page Elements
- Select Footer
- Add content as needed, for example confidentiality or version information
- To add page numbers, select Options, Page Numbers
- To add page count, select Insert, Page Elements, Page Numbers, Page Count
- Select Options to access the Format Footer menu to adjust margins or layout
Add Page Numbers
Always use the built-in Page Number tool (Insert > Page numbers) instead of manually typing numbers. This ensures page numbers are automatically updated as pages are added or removed from the document.
Add Page Numbers
- Select Insert
- Select Page Elements
- Select Page Numbers
- Select the configuration you want or select More Options
Review for Accessibility
You’ve done an amazing job building an accessible document! The final step before sharing is to do a final review for accessibility. This ensures your document meets all requirements and nothing has been missed.
In Google Docs this means using the Grackle Docs accessibility checker. For more details on how to use and troubleshoot any errors found in the checker, visit the Grackle Docs page.