Tips on Writing for Web Accessibility

This page introduces some basic considerations to help you get started writing web content that is more accessible to people with disabilities. These tips are good practice to help you meet Web Content Accessibility Guidelines (WCAG) requirements. Follow the links to the related WCAG requirements, detailed background in the "Understanding" document, guidance from Tutorials, user stories, and more.

On this page

For each web page, provide a short title that describes the page content and distinguishes it from other pages. The page title is often the same as the main heading of the page. Put the unique and most relevant information first; for example, put the name of the page before the name of the organization. For pages that are part of a multi-step process, include the current step in the page title.

Use short headings to group related paragraphs and clearly describe the sections. Good headings provide an outline of the content.

Write link text so that it describes the content of the link target. Avoid using ambiguous link text, such as 'click here' or 'read more'. Indicate relevant information about the link target, such as document type and size, for example, 'Proposal Documents (RTF, 20MB)'.

For every image, write alternative text that provides the information or function of the image. For purely decorative images, there is no need to write alternative text.

For audio-only content, such a podcast, provide a transcript. For audio and visual content, such as training videos, also provide captions. Include in the transcripts and captions the spoken information and sounds that are important for understanding the content, for example, 'door creaks'. For video transcripts, also include a description of the important visual content, for example 'Athan leaves the room'.

Ensure that instructions, guidance, and error messages are clear, easy to understand, and avoid unnecessarily technical language. Describe input requirements, such as date formats.

Use simple language and formatting, as appropriate for the context.

  • Write in short, clear sentences and paragraphs.
  • Avoid using unnecessarily complex words and phrases. Consider providing a glossary for terms readers may not know.
  • Expand acronyms on first use. For example, Web Content Accessibility Guidelines (WCAG).
  • Consider providing a glossary for terms readers may not know.
  • Use list formatting as appropriate.
  • Consider using images, illustrations, video, audio, and symbols to help clarify meaning.

These tips are a few of the things you need to consider for web accessibility. The following resources help you learn why accessibility is important, and about guidelines for making the web more accessible to people with disabilities.