Checklist

Determine how accessible your site is

Introduction

This checklist uses the The Web Content Accessibility Guidelines (WCAG) as a reference point. The WCAG is a shared standard for web content accessibility for individuals, organizations, and governments.

There are three levels of accessibility compliance in the WCAG, which reflect the priority of support:

  1. A: Essential. If this isn't met, assistive technology may not be able to read, understand, or fully operate the page or view.
  2. AA: Ideal support. Now required for EU government and public body websites.
  3. AAA: High-level support. This is typically reserved for sites that serve a specialized audience.

This checklist targets many, but not all level A and AA concerns. Note that the different levels of WCAG support do not necessarily indicate an increased level of difficulty to implement.

Success criteria

Each item on this checklist has a corresponding WCAG "success criterion." Success criterion are the specific, testable rules that power the WCAG, described by a reference number and short title. For example, the rule about text resizing is called 1.4.4 Resize text.

Some accessibility issues may have multiple success criterion apply to them. We have identified the most relevant for each checklist item.

Does this checklist guarantee my site is accessible?

No. However, addressing the issues called out in this checklist will help improve the experience for everyone who uses your site.

The issues this checklist prompts you to check for covers a wide range of disability conditions. There is no such thing as "perfect accessibility" or a site being "100% accessible". You should be wary of companies and services that make such promises. If you need professional accessibility help, use professional accessibility services.

Content

Content is the most important part of your site.

Use plain language and avoid figures of speech, idioms, and complicated metaphors.
Make sure that button, a, and label element content is unique and descriptive.

1.3.1 Info and Relationships

Terms like "click here" and "read more" do not provide any context. Some people navigate using a list of all buttons or links on a page or view. When using this mode, the terms indicate what will happen if navigated to or activated.

Use left-aligned text for left-to-right languages, and right-aligned text for right-to-left languages.

1.3.1 Info and Relationships

Centered-aligned or justified text is difficult to read.

Global code

Global code is code that affects your entire website.

Validate your HTML.

4.1.1 Parsing

Valid HTML helps to provide an consistent, expected experience across all browsers and assistive technology.

Use a lang attribute on the html element.

3.1.1 Language of Page

This helps screen readers to pronounce content correctly.

Provide a unique title for each page or view.

2.4.2 Page Titled

The title element, contained in the document's head element, is often the first piece of information announced by assistive technology. This helps tell people what page or view they are going to start navigating.

Ensure that viewport zoom is not disabled.

1.4.4 Resize text

Some people need to increase the size of text to a point where they can read it. Do not stop them from doing this, even for sites with a native app-like experience (even native apps should respect Operating System settings for resizing text).

Use landmark elements to indicate important content regions.

4.1.2 Name, Role, Value

Landmark regions help communicate the layout and important areas of a page or view, and can allow quick access to these regions. For example, use the nav element to wrap a site's navigation, or the main element to contain the primary content of a page.

Ensure a linear content flow.

2.4.3 Focus Order

Remove tabindex attribute values that aren't either 0 or -1. Elements that are inherently focusable, such as links or buttons, do not require a tabindex. Elements that are not inherently focusable should not have a tabindex applied to them outside of very specific use cases.

Avoid using the autofocus attribute.

2.4.3 Focus Order

People who are blind or who have low vision may be disoriented when focus is moved without their permission. Additionally, autofocus can be problematic for people with motor control disabilities, as it may create extra work for them to navigate out from the autofocused area and to other locationso on the page/view.

Remove session timeouts.

2.2.1 Timing Adjustable

If you cannot, let the person using your site know the timeout exists ahead of time, and provide significant notice before the timer runs out.

Remove title attribute tooltips.

4.1.2 Name, Role, Value

The title attribute has numerous issues, and should not be used if the information provided is important for all people to access. An acceptable use for title would be labeling an iframe element to indicate what content it contains.

Keyboard

It is important that your interface and content can be operated, and navigated by use of a keyboard. Some people cannot use a mouse, or may be using other assistive technologies that may not allow for "hovering" or precise clicking.

Make sure there is a visible focus style for interactive elements that are navigated to via keyboard input.

2.4.7 Focus Visible

Can a person navigating with a keyboard, switch, or screen reader see where they currently are on the page?

Check to see that keyboard focus order matches the visual layout.

1.3.2 Meaningful Sequence

Can a person navigating with a keyboard or screen reader move around the page in a predictable way?

Remove invisible focusable elements.

2.4.3 Focus Order

Remove the ability to focus on elements that are not presently meant to be discoverable. This includes things like inactive drop down menus, off screen navigations, or modals.

Images

Images are a very common part of most websites. There are techniques you can use to help make sure they are enjoyable by all.

All images

Make sure that all img elements have an alt attribute.

1.1.1 Non-text Content.

alt attributes (alt text) give a description of an image for people who may not be able to view them. When an altttribute isn't present on an image, a screen reader may announce the image's file name and path instead, failing to communicate the image’s content.

Make sure that decorative images have empty alt attribute values.

1.1.1 Non-text Content

Decorative images do not communicate information that is required to understanding the website's content. Historically they were used for flourishes and spacer gif images, but are less relevant for modern websites. Empty alt attributes are also sometimes known as null alt attributes.

Provide a text alternative for complex images such as charts, graphs, and maps.

1.1.1 Non-text Content

Is there a plain text which lists points on the map or sections of a flowchart? Describe all visible information. This includes graph axes, data points and labels, and the overall point the graphic is communicating.

For images containing text, make sure the alt description includes the image's text.

1.1.1 Non-text Content

For example, the FedEx logo should have an alt value of "FedEx."

SVGs

SVGs are images described using markup.

Make sure that svg elements include the code focusable="false" when they are the child element of a focusable element.

1.3.1 Info and Relationships

This prevents Internet Explorer from allowing focus to navigate through the child elements of an SVG that is meant to be decorative.

Add aria-hidden="true" to svg that is decorative.

4.1.2 Name, Role, Value

This is equivalent to an empty/null alt value on a non-svg image.

Make sure that svg utilizing the use element has whitespace between the svg and use elements.

2.1.2 No Keyboard Trap

This solves a bug in Safari which sometimes creates hidden tab-stops when navigating.

Ensure that img elements with an svg source includes the role="img" attribute.

4.1.2 Name, Role, Value

VoiceOver on macOS and iOS will not correctly convey the element as an image if role="img" is not present.

Headings

Heading elements (h1, h2, h3, etc.) help break up the content of the page into related "chunks" of information.

Use heading elements to introduce content.

2.4.6 Headings or Labels

Heading elements construct a document outline, and should not be used for purely visual design.

Use only one h1 element per page or view.

2.4.6 Headings or Labels

The h1 element should be used to communicate the high-level purpose of the page or view. Do not use the h1 element for a heading that does not change between pages or views (for example, the site's name).

Heading elements should be written in a logical sequence.

2.4.6 Headings or Labels

The order of heading elements should descend, based on the "depth" of the content. For example, an h4 element should not appear on a page before an h3 element.

Don't skip heading levels.

2.4.6 Headings or Labels

For example, don't jump from a h2 to a h4, skipping a h3 element. If heading levels are being skipped for a specific visual treatment, use CSS classes instead.

Lists

Lists let people know the content is related, and how many items are included in the grouping.

Use list elements (ol, ul, and dl) for list content.

1.3.1 Info and Relationships

This may include sections of related content, items visually displayed in a grid-like layout, or sibling a elements.

Controls

Controls are interactive elements such as links and buttons that let a person navigate to a destination or perform an action.

Ensure that controls have :focus states.

2.4.7 Focus Visible

Visible focus styles help people determine which interactive element has keyboard focus. This lets them know that they can perform actions like activating a button or navigating to a link's destination.

Use the button element for buttons.

1.3.1 Info and Relationships

Buttons are used to submit data or perform an on-screen action which does not shift keyboard focus.

Tables

Tables are a structured set of data that help people understand the relationships between different types of information.

Use the table element to describe tabular data.

1.3.1 Info and Relationships

Do you need to display data in rows and columns? Use the table element.

Use th for table headers (with appropriate scope attributes).

4.1.1 Parsing

Depending on how complex your table is, you may also consider using scope="col" for column headers, scope="row" for row headers. Many different kinds of assistive technology still use the scope attribute to help them understand and describe the structure of a table.

Use the caption element to provide a title for the table.

2.4.6 Headings or Labels

The table's caption should describe what kind of information the table contains.

Forms

Forms allow people to enter information into a site for processing and manipulation. This includes things like sending messages and placing orders.

All inputs in a form are associated with a corresponding label element.

3.2.2 On Input

Use a for/id pairing to guarantee the highest level of browser/assistive technology support.

Use fieldset and legend elements where appropriate.

1.3.1 Info and Relationships

Does your form contain multiple sections of related inputs? Use fieldset to group them, and legend to provide a label for what this section is for.

Inputs use autocomplete where appropriate.

1.3.5 Identify Input Purpose

Providing a mechanism to help people more quickly, easily, and accurately fill in form fields that ask for common information (for example, name, address, phone number). ted.

Make sure that form input errors are displayed in list above the form after submission.

3.3.1 Error Identification

This provides a way for assistive technology users to quickly have a high-level understanding of what issues are present in the form. This is especially important for larger forms with many inputs. Make sure that each reported error also has a link to the corresponding field with invalid input.

Associate input error messaging with the input it corresponds to.

3.3.1 Error Identification

Techniques such as using aria-describedby allow people who use assistive technology to more easily understand the difference between the input and the error message associated with it.

Make sure that error, warning, and success states are not visually communicated by just color.

1.4.1 Use of Color

People who are color blind, who have other low vision conditions, or different cultural understandings for color may not see the state change, or understand what kind of feedback the state represents if color is the only indicator.

Media

Media includes content such as pre-recorded and live audio and video.

Make sure that media does not autoplay.

1.4.2 Audio Control

Unexpected video and audio can be distracting and disruptive, especially for certain kinds of cognitive disability such as ADHD. Certain kinds of autoplaying video and animation can be a trigger for vestibular and seizure disorders.

Ensure that media controls use appropriate markup.

1.3.1 Info and Relationships

Examples include making sure an audio mute button has a pressed toggle state when active, or that a volume slider uses <input type="range">.

Check to see that all media can be paused.

2.1.1 Keyboard

Provide a global pause function on any media element. If the device has a keyboard, ensure that pressing the Space key can pause playback. Make sure you also don't interfere with the Space key's ability to scroll the page/view when not focusing on a form control.

Video

Confirm the presence of captions.

1.2.2 Captions

Captions allow a person who cannot hear the audio content of a video to still understand its content.

Remove seizure triggers.

2.3.1 Three Flashes or Below Threshold

Certain kinds of strobing or flashing animations will trigger seizures.

Audio

Confirm that transcripts are available.

1.1.1 Non-text Content

Transcripts allow people who cannot hear to still understand the audio content. It also allows people to digest audio content at a pace that is comfortable to them.

Appearance

How your site content looks in any given situation.

Check your content in specialized browsing modes.

1.4.1 Use of Color

Activate modes such as Windows High Contrast or inverted colors. Is your content still legible? Are your icons, borders, links, form fields, and other content still present? Can you distinguish foreground content from the background?

Increase text size to 200%.

1.4.4 Resize text

Is the content still readable? Does increasing the text size cause content to overlap?

Double-check that good proximity between content is maintained.

1.3.3 Sensory Characteristics

Use the straw test to ensure people who depend on screen zoom software can still easily discover all content.

Make sure color isn't the only way information is conveyed.

1.4.1 Use of Color

Can you still see where links are among body content if everything is grayscale?

Use a simple, straightforward, and consistent layout.

1.4.10 Reflow

A complicated layout can be confusing to understand and use.

Animation

Content that moves, either on its own, or when triggered by a person activating a control.

Ensure animations are subtle and not do not flash too much.

2.3.1 Three Flashes or Below Threshold

Certain kinds of strobing or flashing animations will trigger seizures. Others may be distracting and disruptive, especially for certain kinds of cognitive disability such as ADHD.

Provide a mechanism to pause background video.

2.2.2 Pause, Stop, Hide

Background video can be distracting, especially if content is placed over it.

Make sure all animation obeys the prefers-reduced-motion media query.

2.3.3 Animation from Interactions

Remove animations when the "reduce motion" setting is activated. If an animation is necessary to communicate meaning for a concept, slow its duration down.

Color contrast

Color contrast is how legible colors are when placed next to, and on top of each other.

Check the contrast for all normal-sized text.

1.4.3 Contrast

Level AA compliance requires a contrast ratio of 4.5:1.

Check the contrast for all large-sized text.

1.4.3 Contrast

Level AA compliance requires a contrast ratio of 3:1.

Check the contrast for all icons.

1.4.11 Non-text Contrast

Level AA compliance requires a contrast ratio of 3.0:1.

Check the contrast of borders for input elements (text input, radio buttons, checkboxes, etc.).

1.4.11 Non-text Contrast

Level AA compliance requires a contrast ratio of 3.0:1.

Check text that overlaps images or video.

1.4.3 Contrast

Is text still legible?

Check custom ::selection colors.

1.4.3 Contrast

Is the color contrast you set in your ::selection CSS declaration sufficient? Otherwise someone may not be able read it if they highlight it.

Mobile/Touch

Things to check to best support different device form factors.

Check that the site can be rotated to any orientation.

1.3.4 Orientation

Does the site only allow portrait orientation?

Remove horizontal scrolling.

1.4.10 Reflow

Requiring someone to scroll horizontally can be difficult for some, irritating for all.

Ensure sufficient space between clickable items in order to provide a scroll area.

2.4.1 Bypass Blocks

Some people who experience hand tremors have a very difficult time scrolling past clickable items which feature zero spacing.