Editorial team ·

Write an accessibility report a designer can replay in minutes

Editorial cover: Write an accessibility report a designer can replay in minutes
AI-generated illustration.

“The page is cramped when I zoom” describes a feeling that many people share. It still leaves the designer hunting for the broken part. Try “At 200 percent zoom, the fixed action bar covers the error under Email.” Add the short route that put you there and you can test the same thing together.

Make the report easy to run from the start

A short report for a fictional registration form
Field Example entry
Setup Workshop form, Chrome, browser zoom at 200 percent
Steps Leave Email blank and submit using the keyboard
Observed Fixed bar covers the last line below Email
Pass condition Full error remains readable and both the field and Submit are reachable

For the fictional example, include the build and the workshop registration screen. Record the starting window size, the 200 percent zoom setting, and the field you left blank. Use test data when the form asks for private details.

Write down what changed after Submit. The error message is displayed below Email, but its final line is hidden behind the fixed action bar. The screenshot needs the field, the covered message, and the bar rather than every part of the page.

Add the success condition in everyday language: “After submitting with Email blank, I can read the entire error and reach the Email field and Submit using the keyboard.” That makes the report reusable if the designer chooses a different layout.

Give the designer the exact setup and try a second view as a comparison. Say which width and zoom passed and which one failed. That helps narrow the work without claiming every other screen has been tested.

Describe how you will know the task works again

  1. Reproduce from a clean view
    • Record the starting window and the zoom.
    • List only the steps needed for this failure.
  2. Set up the retest
    • Attach a cropped screenshot with enough context.
    • Describe the participant’s task in the pass condition.

Questions and answers

Should I tell the designer exactly which CSS rule to change?
Include a suspected cause if you confirmed it. Keep the expected result clear enough to test even if the fix uses a different approach.
What if the issue appears only at one zoom level?
Report that level and the viewport. Add passing comparison points if you tested them.
Do I put the standard in the title?
Name the visible problem in the title. Add the relevant criterion to the report when it helps explain the requirement.