Skip to main content

Accessibility & Compliance

Accessibility checks, color contrast, screen reader structure, captions and narration, keyboard navigation, and language support

Written by Patrick Elzinga

Mindsmith gives you tools to build lessons that work for every learner, including people who use screen readers, keyboards, or captions. This guide covers what Mindsmith handles automatically and what you control as an author.

Check your lesson before sharing

When you share a lesson, Review before sharing runs accessibility checks and flags common problems:

  • Images without alt text

  • Text with low color contrast

  • Headings that skip a level, such as a Title followed directly by a Subheading

  • Charts without a screen reader description

Fix each issue yourself, or click Fix with agent to have Mindsmith's AI fix it for you.

Tip: When you generate a lesson with AI, choose the Accessible & Inclusive recipe. It builds in alt text, captions, strong contrast, and a clear structure from the start.

Color contrast and readability

The theme editor helps you keep text readable:

  • Auto-color text picks high-contrast text colors based on your page background.

  • Contrast warnings appear when body text falls below the WCAG minimum contrast ratio of 4.5:1. The theme preview also shows the current contrast ratio.

  • Text scale lets you make all text in your theme larger.

Avoid relying on color alone to convey meaning. Pair color-coded elements with text labels or icons.

Structure for screen readers

  • Headings: The Title, Heading, and Subheading styles become real headings (H1, H2, H3) that screen reader users can jump between. Use them in order.

  • Alt text: Click the ALT badge on any image to describe it. If an image is purely decorative, enter a single space so screen readers skip it.

  • Tables: Turn on Header Row or Header Column so screen readers announce headers as learners move through cells.

  • Charts: Fill in the chart's Aria Label with a short summary of what the chart shows.

  • Checklists: Use the list tile's Checkbox mode for real, labeled checkboxes.

Captions, transcripts, and narration

  • Video: Upload a .vtt caption file, or (on Enterprise plans) click Generate Captions + Transcript. You can also add a full transcript, which learners can open from the player. See video tiles.

  • Audio: Add a transcript to any audio tile.

  • Narration: Add text-to-speech narration to a whole lesson, a page, or a single tile. Learners can turn autoplay off.

  • Conversations: Set a conversation tile's Input Mode to Voice & Text or Text Only so learners who can't use a microphone can still take part.

Keyboard navigation

Learners can complete lessons without a mouse:

  • A Skip to Main Content link and visible focus outlines make keyboard navigation easy to follow.

  • Buttons, flashcards, and accordions work with Tab, Enter, and Space. Tabs switch with the arrow keys.

  • In questions, learners can press number keys 1–9 to choose an answer and Enter to submit.

  • Drag-and-drop activities have keyboard alternatives. In matching, select an item and press Enter on its match. In sorting, use Place in…. In ranking, use the move up and move down buttons.

  • Screen readers announce results after a learner submits an answer.

Language support

Learners can switch languages with Change Language, and screen readers pick up the new language automatically. Right-to-left languages, such as Arabic and Hebrew, display right to left.

Did this answer your question?