Make your OneNote notebooks accessible to people with disabilities
Applies ToOneNote for Microsoft 365 OneNote for Microsoft 365 for Mac OneNote for the web OneNote 2024 OneNote 2024 for Mac OneNote 2021 OneNote 2021 for Mac OneNote for Windows 10 OneNote 2016 OneNote for Mac OneNote for iOS OneNote for Android phones

This topic gives you step-by-step instructions on how to make your OneNote notebooks accessible and unlock your content to everyone, including people with disabilities.

You learn, for example, how to work with the Accessibility Checker to tackle accessibility issues while writing your notebook. You'll also learn how to add alt texts to images so that people using screen readers are able to listen to what the image is all about. You can also read about how to use font colors and styles to maximize the inclusiveness of your notebook before sharing it with others.

Best practices for making OneNote notebooks accessible

The following table includes key best practices for creating OneNote notebooks that are accessible to people with disabilities.

What to fix

How to find it

Why fix it

How to fix it

Include alternative text with all visuals and embedded files.

To find missing alternative text, use the Accessibility Checker.

Alternative text helps people who can’t see the screen to understand what’s important in images, other visuals, and embedded files.

Add alt text to visuals and embedded files

Add meaningful and accurate hyperlink text.

To determine whether hyperlink text makes sense as standalone information, visually scan your notebook.

People who use screen readers sometimes scan a list of links.

Add accessible hyperlink text

Give section groups, sections, and pages unique names, and remove empty items.

To determine whether you have named all content and deleted empty items, visually scan your notebook.

Notebooks with content named descriptively make it easier to find specific information. This also helps people using screen readers as they can know what an item contains without opening it.

Rename sections and section groups

Delete unused sections and section groups

Add a page title or rename a page

Delete unused pages

Ensure that color is not the only means of conveying information.

Use the Automatic font color for your text. Visually scan your notebook for instances of color-coding.

People who are blind, have low vision, or are colorblind might miss out on the meaning conveyed by particular colors.

Use accessible text color and formatting

If you must use tables, create a simple table structure for data only, and specify column header information.

To ensure that tables don't contain split cells, merged cells, or nested tables, use the Accessibility Checker.

Screen readers keep track of their location in a table by counting table cells. 

Screen readers also use header information to identify rows and columns.

Avoid using tables

Use table headers

Use a larger font size (18pt or larger), sans serif fonts, and sufficient white space.

To find potential issues related to fonts or white space, review your pages for areas that look crowded or illegible.

People who have dyslexia describe seeing text merge or distort.

Use accessible text color and formatting

Use accessible text alignment and spacing

Make audio and video files accessible to people who are blind or have low vision or people who are deaf or hard-of-hearing.

Where possible, ensure that audio and video files have subtitles, closed captions, or video descriptions before being inserted into OneNote.

Make audio and video files accessible

Use built-in headings and styles.

Screen reader software recognizes built-in heading styles as headings and enables people to navigate by heading.

In addition, people with reading disorders such as dyslexia depend on headings to help them structure information. 

Use headings to organize the information in your notes into small chunks which are arranged in a logical order.

To find headings that are not in a logical order, use the Accessibility Checker.

Apply built-in heading styles

Top of Page 

Check accessibility while you work in OneNote

The Accessibility Checker is a tool that reviews your content and flags accessibility issues it comes across. It explains why each issue might be a potential problem for someone with a disability. The Accessibility Checker also suggests how you can resolve the issues that appear.

To launch the Accessibility Checker, select Review > Check Accessibility. The Accessibility pane opens, and you can now review and fix accessibility issues. For more info, go to Improve accessibility with the Accessibility Checker.

Top of Page 

Apply built-in heading styles

Use the built-in heading styles to form an outline of the notebook pages for screen readers. Screen readers enable people to navigate by heading, but they cannot interpret a line of text with large and bold font as a heading unless the built-in styles are applied.

Organize headings in the prescribed logical order and do not skip heading levels. For example, use Heading 1, Heading 2, and then Heading 3, rather than Heading 3, Heading 1, and then Heading 2. 

In addition, people with reading disorders such as dyslexia depend on headings to help them structure information, and divide the information into smaller-sized chunks that are easier to process. Ideally, each heading includes only a few paragraphs.

  1. Select the text for the heading.

  2. On the Home tab, select a heading style, such as Heading 2.

    Screenshot of selecting a heading style from the Home menu.

Top of Page 

Avoid using tables

In general, avoid tables if possible and present the data another way, like paragraphs with headings and banners. Tables with fixed width might prove difficult to read for people who use Magnifier, because such tables force the content to a specific size. This makes the font very small, which forces Magnifier users to scroll horizontally especially on mobile devices.

If you have to use tables, use the following guidelines to make sure your table is as accessible as possible:

  • Avoid fixed width tables.

  • Make sure the tables render properly on all devices, including phones and tablets.

  • If you have hyperlinks in your table, edit the link texts, so they make sense and don't break mid-sentence.

  • Make sure the notebook is easily read with Magnifier. View it on your computer and a mobile device to see how it looks on different screens.

  • Use table headers.

  • Test accessibility with Immersive reader.

Use table headers

If you do need to use tables, add headers to your table to help screen readers keep track of the columns and rows. If a table is nested within another table or if a cell is merged or split, the screen reader loses count and can’t provide helpful information about the table after that point. Blank cells in a table could also mislead someone using a screen reader into thinking that there is nothing more in the table. Screen readers also use header information to identify rows and columns.

All tables created in OneNote automatically have a header row. It is possible to remove or add the header row using the OneNote for Windows app. If your notebook has a table with the Header Row option unselected, you can use the Windows app to resolve this issue.

  1. In your table, place the cursor somewhere on the first row.

  2. On the Table tab, select Insert Above.

  3. Right-click the inserted row in the table, and then select Table. Check that Header Row is selected.

  4. Go back to your table and type the column headings.

Top of Page

Add alt text to visuals and embedded files

Alt text helps people who can’t see the screen to understand what’s important in images and other visuals. In alt text, briefly describe the image and mention the existence of text and its intent. Screen readers read the text to describe the image to users who can’t see the image.

You should also add alt text to embedded files, such as supporting materials, job descriptions, or report templates so that screen reader users can hear a description of the file.

  1. Right-click the visual or embedded file, and then select Alt Text.

  2. Type a title and a description for the item.

    Screenshot of the alternative text dialog in OneNote with example texts in the Title and Description fields.

    Depending on your OneNote version, the Description field may already contain a machine-generated alt text. You can edit this text as you see fit.

  3. When you're ready, select OK.

For more info on how to write alt text, go to Everything you need to know to write effective alt text. Visual content includes pictures, SmartArt graphics, shapes, groups, charts, embedded objects, ink, and videos.

To find missing alternative text, use Accessibility Checker. For more info, go to Improve accessibility with the Accessibility Checker.

Notes: 

  • For audio and video content, in addition to alt text, include closed captioning for people who are deaf or hard of hearing.

  • Avoid using text in images as the sole method of conveying important information. If you must use an image with text in it, repeat that text in your notebook.

Top of Page 

Make audio and video files accessible

Where possible, ensure that audio and video files are accessible before being inserted into OneNote. Alternatively, insert an additional file into the notebook to provide supporting subtitles, captions, or video description.

  • Subtitles typically contain a transcription (or translation) of the dialogue.

  • Closed captions typically also describe audio cues such as music or sound effects that occur off-screen.

  • Video description means audio-narrated descriptions of a video's key visual elements. These descriptions are inserted into natural pauses in the program's dialogue. Video description makes video more accessible to people with a vision disability.

Top of Page 

Add accessible hyperlink text

Add meaningful text to a hyperlink to let users know what’s behind the link. People who use screen readers sometimes scan a list of links. Links should convey clear and accurate information about the destination. For example, instead of using link texts such as "Click here," "See this page," "Go here," or "Learn more," include the full title of the destination page.

  1. Select the text to which you want to add the hyperlink.

  2. On the Insert tab, select Link.

  3. The text you selected is shown in the Text to display field. This is the hyperlink text. You can change it if necessary.

    Tip: Avoid using “click here” or similar non-descriptive expressions. The link text should describe the destination page accurately but briefly.

  4. Add the hyperlink URL to the Address field.

    You can copy and paste the address, use the Browse the Web or Browse for File buttons, or pick a location in OneNote to find the destination page, file, or OneNote item.

    Screenshot of the link dialog in OneNote. Contains two fields to fill in: Text to display and Address.
  5. Select OK.

Top of Page 

Use a single note container per page

In OneNote, you can add notes anywhere on a page by clicking and adding content. This creates a new note container.

Having all notes on a page in a single container helps screen reader users read in one place without having to navigate to multiple locations on the page. If a note container becomes too large, you can split it across multiple pages or add descriptive headers. (Screen readers refer to note containers as “content blocks.”)

Top of Page 

Rename sections and section groups

When you name your notebook content descriptively and accurately, it is easier for people to find specific information in your notes. This also helps people using screen readers to know what a section or section group contains without opening it.

  1. In a notebook, right-click the section or section group name you want to edit, and then select Rename.

  2. Type the new name, and then press Enter.

    Screenshot of the context menu with the Rename option selected.

Top of Page 

Delete unused sections and section groups

To help everyone find relevant information quickly, remove any unused sections and section groups that contain no information.

  1. In a notebook, right-click the section or section group you want to remove, and then select Delete.

    Delete section group in OneNote for Windows dialog
  2. In the confirmation dialog box, select Yes.

Top of Page 

Add a page title or rename a page

Pages that are descriptively and accurately titled make it easier to find specific information in your notes. This also helps people using screen readers to know what a page contains without opening it.

  1. In a notebook, open the page you want to name or rename.

  2. Type the name on the page title line above the time and date.

    Rename page in OneNote for the web

Top of Page 

Delete unused pages

To help everyone find relevant information quickly, remove any unused pages that contain no information.

  1. In the page list, right-click the page you want to remove, and then select Delete.

    Delete page in OneNote for Windows dialog

Top of Page 

Use accessible text color and formatting

The text in your notebook should be readable in the high contrast mode so that everyone, including people with visual disabilities, can see it well. To ensure that text displays well in the high contrast mode, use the Automatic setting for font color.

People who are blind, have low vision, or are colorblind might miss the meaning conveyed by particular colors. Make sure you don’t use color alone to convey meaning. Create text that duplicates the meaning of the color or other sensory characteristic.

To make your text more accessible with formatting, select a plain sans-serif font and use a larger font size.

  1. Select the text you want to format.

  2. On the Home tab, click the down arrow on the Font Color button, and then select Automatic.

    Screenshot of the font color option in the Home menu.
  3. On the Home tab, select, for example, a larger font size (18pt or larger) and a familiar sans-serif font, such as Arial or Calibri. You can also use other formatting options, such as bold font for emphasis. Avoid excessive use of block capitals, underlining, and italics.

Top of Page 

Use accessible text alignment and spacing

People with dyslexia perceive text in a way that can make it difficult to distinguish letters and words. For example, they might perceive a line of text compressing into the line below, or adjacent letters seeming to merge.

Align your paragraph to the left to avoid uneven gaps between words, and increase or decrease the white space between lines to improve readability. Include sufficient white space between lines and paragraphs but avoid more than two spaces between words and two blank lines between paragraphs.

  1. Select the text you want to modify.

  2. On the Home tab, select Paragraph Alignment.

  3. To align the paragraph text to the left, select Align Left.

    Screenshot of the Paragraph Alignment options in OneNote 2016.
  4. To modify the line spacing, select Paragraph Spacing Options, and enter the spacing you want to use.

    Screenshot of the Paragraph Spacing Option in the Home menu.

    Note: The paragraph spacing values in OneNote follow a different logic than the values in, for example, Word. In OneNote, you need to enter the total number (in points) for both the current font size and its intended line spacing. For example, to double-space Calibri font size 11, enter 27 into the Line spacing at least field.

Top of Page 

Use bulleted lists

When feasible, break the text into bullet points to improve readability and navigation.

  1. Place the cursor where you want to add the list in your notebook, or select the text to be included in the list.

  2. On the Home tab, select Bullets.

  3. To change the bullet style, click the down arrow on the Bullets button.

    Screenshot of the bullet list item selection in the Home menu.
  4. If needed, type the list items.

    Tip: Use a period or a comma at the end of each list item to make screen readers pause.

Top of Page 

Use ordered lists

Use a numbered list for a sequence, as that is easier to follow than a continuous block of text.

  1. Place the cursor where you want to add the list in your notebook, or select the text to be included in the list.

  2. On the Home tab, select Numbering.

  3. To change the numbering style, click the down arrow on the Numbering button.

    Screenshot of the numbered list option in the Home menu.
  4. If needed, type the list items.

Top of Page 

Test accessibility with Immersive Reader

Try reading the notebook with Immersive Reader to check how it sounds like.

  1. In your notebook, select ViewImmersive Reader. Immersive Reader opens in a new window.

  2. Select (Play) to hear your notebook read aloud.

  3. To exit Immersive Reader, select  (Exit).

For more information, refer to Use Immersive Reader for OneNote.

Top of Page 

See also

Improve accessibility with the Accessibility Checker

Rules for the Accessibility Checker

Make your Word documents accessible to people with disabilities

Make your Excel documents accessible to people with disabilities

Make your PowerPoint presentations accessible to people with disabilities

Make your Outlook email accessible to people with disabilities

Technical support for customers with disabilities

Microsoft wants to provide the best possible experience for all our customers. If you have a disability or questions related to accessibility, please contact the Microsoft Disability Answer Desk for technical assistance. The Disability Answer Desk support team is trained in using many popular assistive technologies and can offer assistance in English, Spanish, French, and American Sign Language. Please go to the Microsoft Disability Answer Desk site to find out the contact details for your region.

If you are a government, commercial, or enterprise user, please contact the enterprise Disability Answer Desk.

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.