Make your OneNote notebooks accessible to people with disabilities

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

Best practices for making OneNote notebooks accessible

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

What to fix

Why fix it

How to fix it

Include alternative text with all visuals and embedded files.

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 hyperlink text.

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

Use accessible hyperlink text

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

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

Rename section groups

Add a title or rename a page

Delete sections

Delete section groups

Delete a page

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

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

Use sufficient contrast for text and background colors.

The text in your notebooks should be readable in high contrast mode so that everyone, including people with visual disabilities, can see it well.

Use accessible text color and formatting

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

People with dyslexia perceive text in a way that can make it difficult to distinguish letters and words.

Use accessible text color and formatting

Use accessible text alignment

Use built-in headings and styles.

Screen readers recognize built-in heading styles as headings and enable people to navigate by headings.

People with reading disorders such as dyslexia depend on headings to help them structure information.

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

Apply built-in heading styles

Create accessible lists

If you must use tables, create a simple table structure for data only.

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

Avoid using tables

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

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 individuals who are blind or have low vision.

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.

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 View Check Accessibility. The Accessibility Checker 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.

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

  1. Select the text for the heading.

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

    Heading style menu in OneNote for Mac,

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.

  • Test accessibility with Immersive Reader.

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, shapes, SmartArt graphics, charts, and other visuals. In alt text, briefly describe the image and mention 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.

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 the page content.

To find missing alternative text, use the Accessibility Checker

For more info on how to write alt text, go to Everything you need to know to write effective alt text

  1. Right-click the image in your notebook, and then select Alt Text.

  2. Type a title and a description in the fields. Keep it short, start with the most important information, and aim to convey the content and functionality of the image. When you're ready, select OK.

    Tip: Fill in both the Title and Description fields, as different screen readers read this information in different ways.

    Alt text dialog for OneNote on Mac.

Top of Page 

Use 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. Press Command+K or 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.

  4. Add the hyperlink URL to the Address field. You can copy and paste the address from the original location.

    Hyperlink dialog in Mac.

  5. Select OK.

Top of Page

Name sections, section groups, and pages descriptively

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.

Rename sections

  1. In the sections list, right-click the section tab you want to edit, and then select Rename.

  2. Type the new section name, and then press Return.

    Section context menu with Rename section highlighted.

Top of Page 

Rename section groups

  1. In the sections list, right-click the section group you want to rename.

  2. Select Rename.

    Rename section group in OneNote for Mac
  3. Type the new name for the section group, and then press Return.

Top of Page 

Add a title or rename a page

  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 Mac

Top of Page 

Delete unused sections, section groups, and pages

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

Delete sections

  1. In the sections list, right-click the section tab you want to remove, and then select Delete Section.

    Section context menu in Mac with Delete Section highlighted.

  2. In the confirmation dialog box, select Yes.

Top of Page 

Delete section groups

  1. In the sections list, right-click the section group you want to remove.

  2. Select Delete.

    Delete section group in OneNote for Mac
  3. In the confirmation dialog box, select Yes.

Top of Page 

Delete a page

  1. In the page list, right-click the page you want to remove.

  2. Select Delete.

    Delete page in OneNote for Mac

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. Use additional means to convey the information, such as a shape or label. For example, consider using a green checkmark to indicate success and a red X to indicate failure, instead of green and red shading.

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 you can select, for example, a larger font size and a sans-serif font. You can also use other formatting options, such as bold font for emphasis.

  3. To change the font color, on the Home tab, expand the Font Color menu, and then select Automatic.

Font color pull down menu in OneNote for Mac.

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. Also, having multiple blank lines or consecutive spaces can make keyboard navigation slow and screen reader usage more cumbersome.

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, expand the Paragraph Alignment menu, and then select Align Left.

The Paragraph Alignment menu in OneNote for Mac.

Top of Page 

Create accessible lists

To make it easier for screen readers to read your pages, organize the information into small chunks such as bulleted or numbered lists.

Design lists so that you do not need to add a plain paragraph without a bullet or number to the middle of a list. If your list is broken up by a plain paragraph, some screen readers might announce the number of list items wrong. Also, the user might hear in the middle of the list that they are leaving the list. 

  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  The Bullets button in OneNote for Mac. (Bullets) or  The Numbering button in OneNote for Mac. (Numbering).

  3. To change the bullet or numbering style, expand the Bullets or Numbering menu, and then select a style you want.

    Bulleted list pull down menu in Mac.
  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 

Test accessibility with Immersive Reader

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

  1. In your notebook, select View Immersive Reader.

  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

Best practices for making OneNote notebooks accessible

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

What to fix

Why fix it

How to fix it

Include alternative text with all pictures and embedded files.

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 images

Add alt text to embedded files

Add meaningful hyperlink text.

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

Add meaningful hyperlink text

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

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 a section or section group

Rename a page

Delete a section or section group

Delete a page

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

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

Use accessible text formatting

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

People with dyslexia might perceive text in a way that can make it difficult to distinguish letters and words.

Use accessible text formatting

Use appropriate text alignment

Use accessible lists

Keep information in a single note container.

In OneNote, you can add notes anywhere on a page by clicking or tapping and then 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.

Try moving all of the information on a page into a single note container. 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.”)

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

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 individuals who are blind or have low vision.

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.

Top of Page 

Add alt text to images and embedded files

Alt text helps people who use screen readers to understand what’s important in the images and embedded files. In the alt text, describe the content of the image or file and mention its intent. Keep it brief but include descriptions of what's important about the image or file. Screen readers read the description to users who can’t see the content.

For detailed info on how to write alt text, go to Everything you need to know to write effective alt text

Add alt text to images 

  1. On the notebook page, tap and hold the image.

  2. In the context menu, swipe left, and then select Alt Text.

  3. Type a description for the image. When you're ready, select Done.

    Alt text dialog box for images in OneNote for iOS.

Top of Page  

Add alt text to embedded files

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. On the notebook page, tap and hold the file.

  2. In the context menu, swipe left, and then select Alt Text.

  3. Type a description for the file and select Done.

    Alt text dialog box for an embedded file in OneNote for iOS.

Top of Page  

Add meaningful 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 menu bar, swipe left and select  Insert link button in OneNote for iOS. (Insert hyperlink).

  3. The text you selected is shown in the DISPLAY text field. This is the hyperlink text. You can now change it if necessary.

  4. Type or paste the hyperlink URL into the ADDRESS text field, and then select Done.

    The Insert Hyperlink dialog box in OneNote for iOS showing the link display text "Make your content accessible to everyone" and its link URL.

Top of Page  

Name your sections, section groups, and pages descriptively

Descriptive and accurately titled sections, section groups, and pages help users find the section they need.

Rename a section or section group

  1. In the Sections list, select Edit.

  2. Select the section tab or section group you want to rename, and on the menu bar, select  Rename section or section group button in OneNote for iOS (Rename).

    Rename section button in the menu bar in iPhone.
  3. Type the new name, and then select Done.

Top of Page  

Rename a page

Descriptive and accurately titled pages help users find the correct page.

  1. In the Pages list, select the page you want to name or rename.

  2. On the page title line above the time and date, modify the page name.

    Rename page in OneNote for iOS

Top of Page  

Delete unused sections, section groups, and pages

To help screen readers and users find relevant information quickly, remove any unused sections, section groups, and pages that contain no information.

Delete a section or section group

  1. In the Sections list, select Edit.

  2. Select the section tab or section group you want to remove, and on the menu bar, select  Delete page, section, or section group button in OneNote for iOS (Delete).

  3. In the confirmation dialog box, select Delete.

Top of Page  

Delete a page

  1. In the Pages list, select Edit.

  2. Select the page you want to remove, and on the menu bar, select  Delete page, section, or section group button in OneNote for iOS (Delete).

    Delete page in OneNote for iOS

Top of Page  

Use accessible text formatting

To make your text formatting more accessible, select a plain sans-serif font, use a larger font size, align your text to the left, and avoid excessive use of block capitals and italics.

To change the text colors to increase the contrast between the text and the background, switch to the full desktop or Windows 10 app version of OneNote. For instructions on how to change the text color in OneNote for Windows, OneNote for Mac, or OneNote for Windows 10, go to the respective tab and section in this topic.

Apply text formatting

  1. Select the text you want to format.

  2. On the menu bar, swipe left and select the option you want. You can select, for example, bold or italic font, or underline for emphasis.

    Bold text button on the menu bar in iPhone.

Top of Page  

Change the font type and size

  1. In the Sections view, select  More actions button in OneNote for iOS. (More actions) > Settings.

    Settings button in Notebooks on iPhone.
  2. Select Edit and View.

  3. Select a larger default font size and a sans-serif default font.

    The Edit and View menu in OneNote for iOS settings.

Top of Page  

Use appropriate text alignment

Align your paragraphs to the left to avoid uneven gaps between words.

  1. Select the text to modify.

  2. On the menu bar, select  Decrease indent button in OneNote for iOS. (Decrease indent).

Top of Page  

Use accessible lists

When feasible, break continuous text into bulleted or numbered lists 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 menu bar, select  The bullets button in OneNote for iOS. (Bullets) or  The numbering button in OneNote for iOS. (Numbering).

  3. 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  

Test the accessibility of your pages 

When your page is ready, you can try a few things to make sure the pages are accessible:

  • Switch to the full desktop or web version of OneNote, and then run the Accessibility Checker. 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. For instructions, go to Improve accessibility with the Accessibility Checker.

  • In the OneNote for iOS app, you can try navigating the pages using the built-in screen reader, VoiceOver. VoiceOver comes with iOS, so there's no need to install anything. This is one additional way to spot issues in the navigation order, for example.

    1. To turn on VoiceOver, in your device settings, select Accessibility > VoiceOver, and then turn on the VoiceOver switch.

    2. To navigate the content on the page, swipe left or right. Modify the reading order of the elements on the page if necessary.

  • Try reading the page with Immersive Reader to check how it sounds like. Immersive Reader is a free tool, built into OneNote, which might improve reading and writing for people regardless of their age or ability.

    • In the OneNote for iOS app, open the page you want to read with Immersive Reader, and then select (Page actions) > Immersive Reader.

    • For instructions on how to use Immersive Reader on the full desktop version of OneNote, go to Use Immersive Reader for OneNote.

Top of Page  

See also

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

Best practices for making OneNote notebooks accessible

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

What to fix

Why fix it

How to fix it

Include alternative text with all pictures and embedded files.

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 images and embedded files

Add meaningful hyperlink text.

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

Add meaningful hyperlink text

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

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 a section

Rename a page

Delete a section

Delete a page

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

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

Use accessible text formatting

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

People with dyslexia might 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.

Use accessible text formatting

Use appropriate text alignment

Create accessible lists

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

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 individuals who are blind or have low vision.

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.

Top of Page 

Add alt text to images and embedded files

Alt text helps people who use screen readers to understand what’s important in the images and embedded files. In the alt text, describe the content of the image or file and mention its intent. Keep it brief but include descriptions of what's important about the image or file. Screen readers read the description to users who can’t see the content.

For detailed info on how to write alt text, go to Everything you need to know to write effective alt text

Add alt text to images

Avoid using text in images as the sole method of conveying important information. If you use images with text in them, repeat the text in the alt text. If your image is decorative, mention that in the alt text.

  1. Tap and hold the image in your notebook.

  2. In the context menu, select Alt Text.

  3. Type a title and description for the image. When you're ready, select DONE.

    Tip: Fill in both the Title and Description fields, as different screen readers read this information in different ways.

Top of Page  

Add alt text to embedded files

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. On a notebook page, tap and hold the file where you want to add alt text.

  2. In the context menu, select Alt Text.

  3. Type a description for the file, and then select DONE.

Top of Page  

Add meaningful 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 menu bar, swipe left, and then select  Insert hyperlink button in OneNote for Android. (Insert hyperlink). The text you selected is shown in the Text to display field. This is the hyperlink text. You can change it if necessary.

  3. Type or paste the hyperlink URL into the Address field.

  4. Select DONE.

    Add hyperlink dialog in OneNote for Android

Top of Page  

Name your sections and pages descriptively

Descriptive and accurately titled sections and pages help users find the information they need.

To rename section groups, switch to the full desktop or Windows 10 app version of OneNote. For instructions on how to rename section groups in OneNote for Windows, OneNote for Mac, or OneNote for Windows 10, go to the respective tab and section in this topic.

Rename a section

  1. In the SECTIONS list, tap and hold the section you want to rename.

  2. In the menu bar, select  The Rename button in OneNote for Android. (Rename section).

  3. Type the new name and select RENAME.

Top of Page  

Rename a page

  1. In the PAGES list, select the page you want to rename.

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

    The page title field in OneNote for Android.

Top of Page  

Delete unused sections and pages

To help screen readers and users find relevant information quickly, remove any unused sections and pages that contain no information.

To delete section groups, switch to the full desktop or Windows 10 app version of OneNote. For instructions on how to delete section groups in OneNote for Windows, OneNote for Mac, or OneNote for Windows 10, go to the respective tab and section in this topic.

Delete a section

  1. In the SECTIONS list, tap and hold the section you want to remove.

  2. In the menu bar, select  Delete button in OneNote for Android. (Delete section).

  3. In the confirmation dialog box, select DELETE.

Top of Page  

Delete a page

To help screen readers and users find relevant information quickly, remove any unused pages that contain no information.

  1. In the PAGES list, tap and hold the page you want to remove.

  2. In the menu bar, select  Delete button in OneNote for Android. (Delete page).

  3. In the confirmation dialog box, select DELETE.

Top of Page  

Use accessible text formatting

Accessible text formatting doesn't exclude or slow down the reading speed of anyone reading a page in your notebook, including people with low vision or reading disability or people who are blind. The right formatting improves the legibility and readability of the page.

To change the font type and size, switch to the full desktop, Windows 10 app, or web version of OneNote. For instructions on how to change the font type and size in OneNote for Windows, OneNote for Mac, OneNote for Windows 10, or OneNote for the web, go to the respective tab and section in this topic.

To make your text more accessible with formatting in the OneNote for Android app, you can, for example, use bold font, align your text to the left, and avoid excessive use of block capitals and italics.

  1. Select the text you want to format.

  2. On the menu bar, select the option you want. You can, for example, use bold font or underline for emphasis.

    Text formatting buttons on toolbar in OneNote for Android

Top of Page 

Use appropriate text alignment

Align your paragraphs to the left to avoid uneven gaps between words.

  1. Select the text you want to align.

  2. On the menu bar, select Decrease indent button in OneNote for Android. (Decrease indent).

Top of Page  

Create accessible lists

To make it easier for screen readers to read your pages, organize the information into small chunks such as bulleted or numbered lists.

Design lists so that you do not need to add a plain paragraph without a bullet or number to the middle of a list. If your list is broken up by a plain paragraph, some screen readers might announce the number of list items wrong. Also, the user might hear in the middle of the list that they are leaving the list. 

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

  2. On the menu bar, select  Bullets button in OneNote for Android. (Bullets) or  Numbering button in OneNote for Android. (Numbering).

  3. 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  

Test the accessibility of your pages

When your page is ready, you can try a few things to make sure the pages are accessible:

  • Switch to the full desktop or web version of OneNote and do one or both of the following:

    • Run the Accessibility Checker. 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. For instructions, go to Improve accessibility with the Accessibility Checker.

    • Try reading the page with Immersive Reader to check how it sounds like. Immersive Reader is a free tool, built into OneNote, that might improve reading and writing for people regardless of their age or ability. For instructions, go to Use Immersive Reader for OneNote.

  • In the OneNote for Android app, you can try navigating the pages using the built-in screen reader, TalkBack. TalkBack comes with Android, so there's no need to install anything. This is one additional way to spot issues in the navigation order, for example.

    1. To turn on TalkBack, in your device settings, select Accessibility > TalkBack > Use service.

    2. To navigate the content on the page, swipe left or right. Modify the reading order of the elements on the page if necessary.

Top of Page  

See also

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

Best practices for making OneNote notebooks accessible 

The following table includes best practices in OneNote for Windows 10 for creating notebooks that are accessible to all people.

What to fix

Why fix it

How to fix it

Avoid common accessibility issues such as missing alternative text (alt text) and low contrast colors.

Make it easy for everyone to read your slides.

Check accessibility while you work in OneNote

Use built-in headings and styles.

Screen readers recognize built-in heading styles as headings and enable people to navigate by headings.

People with reading disorders such as dyslexia depend on headings to help them structure information.

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

Apply built-in heading styles

Create accessible lists

Keep information in a single note container.

Having notes on a page in several containers makes the page navigation more difficult for people who use screen readers.

Use a single note container per page

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

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

Include alt text with all pictures and embedded files.

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

To find missing alt text, use the Accessibility Checker.

Add alt text to visuals and embedded files

Add meaningful hyperlink text.

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

Use accessible hyperlink texts

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

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, section groups, and pages

Delete unused sections, section groups, and pages

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

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

Use sufficient contrast for text and background colors.

The text in your notebooks should be readable in high contrast mode so that everyone, including people with visual disabilities, can see it well.

Use accessible text color and formatting

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

People with dyslexia might perceive text in a way that can make it difficult to distinguish letters and words.

Use accessible text color and formatting

Use accessible text alignment and spacing

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

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 individuals who are blind or have low vision.

Make audio and video files accessible

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 View Check Accessibility. The Accessibility Checker 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  The down arrow button for expanding menus in OneNote for Windows 10. (Styles) to expand the menu, and then select a heading style, such as Heading 2.

    The Styles menu showing different heading styles in OneNote for Windows 10.

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  

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. To insert a table header to a table that you've created in OneNote for Windows 10, switch to the full desktop version of OneNote.

  • Test accessibility with Immersive Reader.

Top of Page  

Add alt text to visuals and embedded files

Alt text helps people who use screen readers to understand what’s important in the visuals in your slides. Visual content includes pictures, SmartArt graphics, shapes, groups, charts, ink, and videos. 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.

In alt text, briefly describe the image, its intent, and what is important about the image. Screen readers read the description to users who can’t see the content.

Tip: To write a good alt text, make sure to convey the content and the purpose of the image in a concise and unambiguous manner. The alt text shouldn’t be longer than a short sentence or two—most of the time a few thoughtfully selected words will do. Do not repeat the surrounding textual content as alt text or use phrases referring to images, such as, "a graphic of" or "an image of." For more info on how to write alt text, go to Everything you need to know to write effective alt text.

Avoid using text in images as the sole method of conveying important information. If you use images with text in them, repeat the text in the slide. In alt text of such images, mention the existence of the text and its intent. 

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

Add alt text to visuals 

  1. Right-click an image in your notebook, and then select Alt Text.

  2. Type a title and a description in the fields. When you're ready, select Done.

    Tip: Fill in both the Title and Description fields, as different screen readers read this information in different ways.

    Alt text dialog for adding alt text in OneNote for Windows 10.

Top of Page   

Add alt text to embedded files

  1. Right-click the file on the page.

  2. Select  Alt text button for embedded files in OneNote for Windows 10. (Alt Text).

  3. Type a title and a description for the file, and then select Done.

    An example of an alt text for an embedded file in OneNote for Windows 10.

Top of Page  

Rename sections, section groups, and pages

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, section group, or page contains without opening it.

Rename sections or section groups 

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

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

Top of Page  

Add a page title or rename a page

  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.

    The page title text fields on a page in OneNote for Windows 10.

Top of Page  

Delete unused sections, section groups, and pages

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

  2. In the confirmation dialog box for sections and section groups, select Yes.

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. Use additional means to convey the information, such as a shape or label. For example, consider using a green checkmark to indicate success and a red X to indicate failure, instead of green and red shading.

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, you can select, for example, a larger font size and a sans-serif font. You can also use other formatting options, such as bold font for emphasis.

    The Font, Font Size, Bold, Italic, and Underline button on the ribbon in OneNote for Windows 10.

  3. To change to font color, on the Home tab, select  The Font Color button for selecting font color in OneNote for Windows 10. (Font Color), and then select Automatic.

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. Also, having multiple blank lines or consecutive spaces can make keyboard navigation slow and screen reader usage more cumbersome.

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  The paragraph formatting button on the Home tab in OneNote for Windows 10. (Paragraph Formatting) to expand the menu, and then select  The align left button in the paragraph format menu in OneNote for Windows 10. (Align Left).

The Paragraph menu showing available options in OneNote for Windows 10.

Top of Page  

Create accessible lists

To make it easier for screen readers to read your pages, organize the information into small chunks such as bulleted or numbered lists.

Design lists so that you do not need to add a plain paragraph without a bullet or number to the middle of a list. If your list is broken up by a plain paragraph, some screen readers might announce the number of list items wrong. Also, the user might hear in the middle of the list that they are leaving the list. 

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

  2. On the Home tab, select  Bullets button on the Home tab in OneNote for Windows 10. (Bullets) or  Numbering button on the Home tab in OneNote for Windows 10. (Numbering).

  3. To change the bullet or numbering style, expand the Bullets or Numbering menu, and then select the style you want.

  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  

Make audio and video files accessible

To make your audio and video files accessible for everyone, make sure the files have subtitles, closed captions, or video descriptions before you insert them 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  

Test accessibility with Immersive Reader 

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

  1. In your notebook, select View Immersive Reader.

  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

Best practices for making OneNote for the web notebooks accessible

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

What to fix

Why fix it

How to fix it

Include alternative text with all pictures, embedded files, and tables.

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

Add alt text to visuals, embedded files, and tables

Add meaningful hyperlink text.

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

Use accessible hyperlink text

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

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.

Name your sections and pages descriptively

Delete unused sections and pages

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

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

Use sufficient contrast for text and background colors.

The text in your notebooks should be readable in high contrast mode so that everyone, including people with visual disabilities, can see it well.

Use accessible text color and formatting

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

People with dyslexia perceive text in a way that can make it difficult to distinguish letters and words.

Use accessible text color and formatting

Use accessible text alignment and spacing

Use built-in headings and styles.

Screen readers recognize built-in heading styles as headings and enable people to navigate by headings.

People with reading disorders such as dyslexia depend on headings to help them structure information.

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

Apply built-in heading styles

Create accessible lists

Keep information in a single note container.

Having notes on a page in several containers makes the page navigation more difficult for people who use screen readers.

Use a single note container per page

If you must use tables, create a simple table structure for data only.

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

Avoid using tables

Where possible, ensure that audio and video files are accessible before being inserted into OneNote.

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

Make audio and video files accessible

Top of Page 

Check accessibility while you work in OneNote for the web  

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 ViewCheck 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 piece of text you want to turn into a heading.

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

The Styles menu in OneNote for the web.

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.

  • Test accessibility with Immersive Reader.

Top of Page 

Add alt text to visuals, embedded files, and tables

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

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 table in your notebook, and then select Alt Text.

  2. Type a description to the text field. For tables, add a title for the alt text, too. Keep it short, start with the most important information, and aim to convey the content and functionality of the visual or table. When you're ready, select OK.

    Alternative text dialog for OneNote for the web

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.

Note: 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

To make your audio and video files accessible for everyone, make sure the files have subtitles, closed captions, or video descriptions before you insert them 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 

Use 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.

If the title on the hyperlink's destination page gives an accurate summary of what’s on the page, use it for the hyperlink text. For example, this hyperlink text matches the title on the destination page: Create more with Microsoft templates.

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

  2. Press Ctrl+K or on the Insert tab, select Insert Link.

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

  4. Type or paste the hyperlink URL to the Address field, and then select Insert.

The Insert Link dialog box in OneNote for the web.

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  

Name sections and pages descriptively

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.

You can rename section groups in the OneNote desktop or Windows 10 app version. For the instructions on how to rename section groups in OneNote desktop or Windows 10 app, go to the respective sections in this topic.

For the step-by-step instructions on how to rename sections or pages, go to Rename a section in OneNote for the web or Rename a page in OneNote for the web.

Top of Page  

Delete unused sections and pages

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

You can delete section groups in the OneNote desktop or Windows 10 app version. For the instructions on how to delete section groups in OneNote desktop or Windows 10 app, go to the respective sections in this topic.

For the step-by-step instructions on how to delete sections or pages, go to Delete a section in OneNote for the web or Delete a page in OneNote for the web.

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. Use additional means to convey the information, such as a shape or label. For example, consider using a green checkmark to indicate success and a red X to indicate failure, instead of green and red shading.

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 you can select, for example, a larger font size and a sans-serif font. You can also use other formatting options, such as bold font for emphasis.

  3. To change the font color, expand the Font Color menu, and then select Automatic.

The Font color menu in OneNote for the web.

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. Also, having multiple blank lines or consecutive spaces can make keyboard navigation slow and screen reader usage more cumbersome.

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, expand the Paragraph Alignment menu, and then select Align Left.

The menu for aligning text in OneNote for the web.

Top of Page  

Create accessible lists

To make it easier for screen readers to read your pages, organize the information into small chunks such as bulleted or numbered lists.

Design lists so that you do not need to add a plain paragraph without a bullet or number to the middle of a list. If your list is broken up by a plain paragraph, some screen readers might announce the number of list items wrong. Also, the user might hear in the middle of the list that they are leaving the list. 

  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 button in OneNote for the Web (Bullet Library) or  The Numbered list button in OneNote for the Web. (Numbering).

  3. To change the bullet or numbering style, expand the Bullet Library or Numbering menu, and then select the style you want.

  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  

Test accessibility with Immersive Reader

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

  1. In your notebook, select View > Immersive Reader.

  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

Rules for the Accessibility Checker

Improve accessibility with 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.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.

Find solutions to common problems or get help from a support agent.