Turtl Docs are by default compliant with ADA and WCAG 2.1 AA regulations, however, all Turtl Docs also have an accessible version, which is also compliant with ADA and WCAG 2.1 AA.

The screen readers that have been tested for compatibility with Turtl are:

This accessible version is mainly used by screen readers. When a screen reader arrives on a Turtl Doc the first thing it reads is 'Press enter to view the accessible version of this page'. You can view this accessible version as well by adding '?accessible' to the end of the Doc URL. For example:

Becomes:

There is one exception to this rule. If the doc is a Personalized, the URL structure changes which adds a '?' into the URL. This means adding another one will not work, instead you will need to add '&'

So

Becomes:

To sum it up:

If there is already '?' in the URL you will need to add '&accessible' at the end of the doc

If there is no '?' in the URL you will need to add '?accessible' at the end of the doc.

Check out this guide to accessibility on Turtl

Turtl Docs are also navigable using only the tab and enter keys. Try this yourself by opening a Doc and pressing tab, you'll be able to see the different buttons highlight as you tab through the page and pressing enter will work the same as clicking on them. See an example below of navigating through the Doc.

When editing Docs, you can also use keyboard shortcuts to aid accessibility. Remind yourself of these shortcuts at any time by pressing Alt+0 while in the Doc editor. 

Here's a list of all the shortcuts available:

Editor Toolbar
Press Alt+F10 to navigate to the toolbar. Move to the next and previous toolbar group with tab and shift+tab. Move to the next and previous toolbar button with the right arrow or left arrow. Press space or enter to activate the toolbar button.
​
​Editor Dialog
Inside a dialog, press tab to navigate to the next dialog element, press shift+tab to move to the previous dialog element, press enter to submit the dialog, press esc to cancel the dialog. When a dialog has multiple tabs, the tab list can be reached either with alt+F10 or with tab as part of the dialog tabbing order. With tab list focused, move to the next and previous tab with right and left arrow, respectively.
​
​Editor Context Menu
Press Shift+F10 or application key to open context-menu. Then move to the next menu option with tab or down arrow. Move to previous option with shift+tab or up arrow. Press space or enter to select the menu option. Open sub-menu of current option with space or enter or right arrow. Go back to the parent menu item with esc or left arrow. Close context menu with esc.
​
​Editor List Box
Inside a list-box, move to the next list item with tab or down arrow. Move to previous list item with shift+tab or up arrow. Press space or enter to select the list option. Press esc to close the list-box.

Undo
Control/Command+Z
​
​Redo
Control/Command+Y
​
​Bold
Control/Command+B

Italic
Control/Command+I

Underline
Control/Command+U
​
​Accessibility Help
Alt+0
​
​Paste as plain text
Shift+Command/Control+V

The audio widget does not have an in-built alt text option, so we recommend layering a Text box widget with a transcript text of the audio underneath the audio widget. On mobile, it's possible to hide it under the 'Mobile' tab in the Text box widget settings.

Alt text is text added within a webpage to describe the appearance and function of media such as images, charts and videos. It is important to add alt text for a few reasons, one being that if the media fails to load then this text will be displayed instead, and another being that this will be the text read out to visually impaired or other readers using screen-readers.

To add alt text to your Surf image or video, hover over the image underneath the 'Media' section and click 'ALT'.

This will open the 'Media settings' box where you can enter your description of the image or video.

To add alt text to media in the Immerse sections of your Turtl Doc, open the media settings and navigate to the 'Misc' tab.

Here are some key tips for writing alternative text in your Turtl Docs:

We cover:

Watch time: 4 minutes

It’s important to keep in mind the order of your Immerse content in the editor to ensure it flows correctly for screen readers and when using the keyboard tab button for navigation. The easiest way to see how your Immerse content flows is by checking your Turtl Doc in mobile view. The order reflected in the mobile view is the same order that will be used for accessibility purposes.

You can see how your Turtl Doc looks on mobile by clicking the mobile preview button in the top right of the editor.

Learn more about how to edit the mobile view of your Turtl Doc here.