Two accessibility problems show up in almost every course review: text that is hard to read against its background, and images that a screen reader either skips when it should not or describes when it should not. Neither is exotic. Both are fixable with a few clear rules and a little discipline. Color contrast in e-learning and alt text are the habits that make the biggest difference for the least effort. What does WCAG actually require for contrast and alt text, and how do you apply it to real slides?

WCAG 2 at level AA requires a contrast ratio of at least 4.5:1 for normal text and 3:1 for large text, and every meaningful image needs a text alternative that serves the same purpose as the image. Large text means at least 18 point, or 14 point bold. Contrast failures usually come from light text on photos, pale grey body text and white text on bright brand colors.

Good alt text describes what an image means in its context, not what it looks like in general, and decorative images get empty alt text so screen readers skip them. Charts and diagrams need a short alternative plus a fuller description nearby.

Color Contrast and Alt Text in E-Learning – Getting Two Common Accessibility Basics Right - 3D Cutaway Animation

What Contrast Ratio Does WCAG AA Require?

WCAG, the Web Content Accessibility Guidelines published by the W3C, sets the requirement in Success Criterion 1.4.3, Contrast (Minimum). The W3C's explanation of contrast minimum gives the figures: 4.5:1 for normal text, and 3:1 for large text, defined as at least 18 point, or 14 point when bold.

A contrast ratio compares the relative brightness of two colors. It runs from 1:1 (identical colors) to 21:1 (black on white). The ratio depends only on the two colors, not on the font or how attractive the pairing looks, which is why it can be checked automatically with any contrast checker.

Three details are often missed:

  • The rule applies to text in images too, such as a heading baked into a banner graphic.
  • Decorative text and logos are exempt, but text that carries information is not.
  • Every state counts. A button label must meet the ratio in its normal, hover, selected and visited states, not just the one in the design mockup. Disabled (inactive) controls are the exception.

Accessibility requirements in law and contracts vary by country and sector. For what applies to your organization, check with your legal counsel or the official source. The figures above describe what WCAG AA asks for.

Where Does Color Contrast in E-Learning Usually Fail?

In predictable places. A quick pass over any course for these spots catches most failures:

  1. White text over photographs, where part of the image is light.
  2. Mid-grey body text chosen to look subtle. A grey of #999999 on white is only about 2.8:1.
  3. White text on bright brand colors, especially orange, yellow and light green.
  4. Feedback colors, such as green "Correct!" text on white.
  5. Hover and selected states that lighten the label.
  6. Small print: footnotes, source lines, copyright notes on gradients.
  7. Captions or labels laid directly over video.

Here is a labelled example with made-up brand colors. Say the brand orange is #F28C28 and the template puts white button labels on it. That pair measures about 2.45:1, which fails even the large-text threshold. A medium green of #2E9E44 with white text reaches about 3.45:1, which passes for large text only. These are the kinds of numbers a checker will show you in seconds.

Photos need a different approach, because the background is not one color. Check the text against the lightest area it overlaps, not the average. If a white heading crosses a bright window in the photo, that is the pair that counts, and a panel or overlay is usually the only reliable fix.

How Do You Fix Contrast Without Wrecking the Brand Colors?

Keep the brand color, change how it is used. Most contrast fixes do not require a new palette, just a few rules about pairings.

  • Put dark text on the bright brand color instead of white. Near-black #1A1A1A on the same orange measures about 7.1:1.
  • Add a darker shade of the brand color for text and buttons. An orange darkened to #B35C00 carries white text at about 4.7:1, and it still reads as the brand.
  • Use the bright brand color for large shapes, borders and icons, and keep body text in dark neutrals.
  • Place text on photos inside a solid or semi-opaque panel, or add a dark overlay behind it.
  • Darken body greys. #767676 on white sits just above 4.5:1; #595959 gives a comfortable 7:1.

Then write the passing pairs down. A one-page table of approved text and background combinations, with their ratios, prevents the same failures from coming back in the next course. Designers tend to welcome it, because it removes a recurring argument.

What Makes Alt Text Useful in a Course?

Useful alt text tells a learner who cannot see the image what they need to know from it, at that point in the course. It depends on purpose and context, which is the central idea of the W3C's images tutorial. The same photo of a fire extinguisher might need "Fire extinguisher mounted beside the exit" on one slide and "Pressure gauge needle in the green zone" on another.

The tutorial groups images by purpose, and the groups map neatly onto course content:

Image typeWeak alt textBetter alt text
Informative photoImage of a warehousePallets stacked above the yellow height line
Functional buttonArrowNext slide
Image containing textPosterReport hazards to your supervisor within one shift
Decorative flourishBlue swirlEmpty (marked decorative)

A few rules of thumb cover most cases. Skip "image of" or "picture of"; screen readers already announce an image. Keep it short, usually a sentence or less. Do not repeat text that is already on the slide next to the image. And for a button, describe the action, not the icon.

Which Images Should Be Marked Decorative?

Images that add nothing a learner would miss if they disappeared. Background textures, divider lines, purely ornamental shapes and generic stock photos placed only for visual interest usually qualify. WCAG Success Criterion 1.1.1 allows decorative content to be implemented so assistive technology can ignore it, which in HTML means empty alt text (alt="") and in most authoring tools means a "decorative" checkbox.

The test is simple: would a learner who cannot see this image lose information or function? If not, mark it decorative. If yes, describe it. Be careful with photos of people. A smiling stock model is usually decorative. A photo showing someone wearing the correct protective equipment is the lesson.

Marking decorative images properly is a kindness, not a shortcut. A screen reader user who hears "blue swirl" eight times per slide quickly learns to distrust every image description in the course.

How Do You Describe Charts and Diagrams?

With two layers: a short alternative that says what the chart is and its main point, and a fuller description available nearby. The short version might read "Bar chart: incident reports fell each quarter". The longer version gives the values or the sequence.

Good places for the longer description in a course:

  • A text summary on the same slide, which helps every learner, not just screen reader users.
  • A "view description" button that opens a layer or panel with the full detail.
  • A simple data table for charts with exact values.
  • A numbered list for process diagrams and flowcharts, one step per item.

Check charts for contrast too. Under WCAG 2.1 and later, meaningful graphics and interface components have their own contrast requirement of 3:1, and colors alone should never be the only way to tell data series apart. Labels or patterns solve both problems at once.

These checks are easy to miss under deadline, so automation helps. AuthorLearn Studio's pre-flight check flags text that fails WCAG AA contrast and images missing alt text before you publish. It can tell you alt text is missing; only you can judge whether the text you wrote is any good.

Good Contrast and Good Alt Text Are Mostly Habits, Not Heroics

Color contrast in e-learning comes down to two numbers, 4.5:1 and 3:1, applied to every text color in every state. Alt text comes down to one question: what does this image mean here? Neither needs a specialist for everyday slides, just consistent habits and an approved palette.

These two basics are only part of an accessible course. Learners also need to operate every interaction and follow every piece of audio, so pair this work with checks on keyboard navigation and captions. Build the palette table once, write alt text as you place each image rather than at the end, and a contrast or alt text finding in review becomes the exception.