Accessible language is language that doesn’t exclude anyone.
People can feel excluded when:
- they don't understand words or phrases
- language is used in ways that pose challenges to users of other technologies, such as text-to-speech software.
People are more likely to use your website if:
- it is easy to navigate
- its information is clear and easy to understand.
Accessibility standard requirements
Many of the Web Content Accessibility Guidelines (WCAG) 2.0 success criteria relate to language. Guideline 3.1 contains 6 success criteria to make text content readable and understandable.
We recommend applying as many of the criteria as you can to make your content easier to read and understand. However, the New Zealand Government Web Accessibility Standard currently requires only:
3.1.1 Language of page — set the main language of your page
To meet WCAG 2.0 Success Criterion 3.1.1, you must identify the default language of each web page. The easiest way to do this is to add the
lang attribute with the correct ISO-639 language code to the
<html> tag. This helps screen readers, and other software that processes text and language, to know how to pronounce or render the content.
<html lang="en">to show a web page is in English
<html lang="en-nz">to show a page is in New Zealand English
<html lang="mi">to show a page is in Māori.
For more information on this requirement, see Understanding Success Criterion 3.1.1.
3.1.2 Language of Parts — indicate any changes in the language on the page
A web page will generally use one language. However, sometimes you may need to include words or a passage in another language. WCAG 2.0 Success Criterion 3.1.2 Language of Parts requires that you show a change in language if it happens. This is so that software can tell it apart from the page's main language.
The easiest way to do this is to add the
lang attribute — with the correct language code — to the HTML element containing the text that’s in a different language. A common way to do this is to add the
lang attribute to a
<span>, or heading tag.
In this example, the opening
<p> tag for the text in te reo Māori uses
lang="mi" to show that the content of that
p element is in te reo Māori:
<p>This sentence is in English, which is the page's main language.</p>
<p lang="mi">Kei roto tēnei rerenga kōrero i te reo Māori.</p>
<p>This is a new paragraph that defaults to the page's main language.</p>
For more information on this requirement, see Understanding Success Criterion 3.1.2.
Setting the language in PDF and Microsoft Word documents
The default language can also be set in PDF and Microsoft Word documents, as can the language of parts of the document where it is different from the default language.
In Microsoft Word, the way you do this depends on the version of Word. In Word 2010, the default language for the document as a whole can be set in the “Language” group of the Word Options dialog window.
To set the language for a passage of text in Word 2010, first select the text and then choose “Set Proofing Language…” from under the “Language” item in the Review tab.
In Adobe Acrobat Pro, you can set the PDF’s default language from the “Advanced” tab in the “Document Properties” dialog window. To open the “Document Properties” dialog, select “Properties…” from the File menu.
Setting the language of a specific passage of text in a PDF is a little more complicated.
Writing for the web
Writing for the web involves thinking about:
- the purpose of the page and the user’s goal
- how people read and process information in an online environment
- how search engines and machines, like screen readers, read online content
- the user’s reading ability, the device they may be using, their computer literacy and their familiarity with your subject.