What is the lang attribute and where do I use it?

The lang attribute defines the language of content in HTML. Place it in the opening tag (e.g., ) to declare the main page language. You can also use it on individual elements to mark content in different languages, such as .

What language codes should I use?

Use ISO 639-1 two-letter codes (e.g., 'en' for English, 'he' for Hebrew, 'de' for German). Extended four-letter codes include region (e.g., 'en-US' for American English), but two-letter codes are usually sufficient.

Do I need to set the direction attribute separately?

Yes. For right-to-left languages like Hebrew or Arabic, also use the dir="rtl" attribute on the element or parent container. This ensures proper text alignment alongside the language declaration.

What happens if I don't declare the language?

Screen readers may guess the language incorrectly and mispronounce text. Users with disabilities rely on correct pronunciation, so missing language declarations harm accessibility and user experience.

Should error messages and alerts match the site language?

Absolutely. All system messages, notifications, and UI text must be in the same language as your site. Mixing languages confuses users and violates accessibility standards.

Language Declaration in HTML: Accessibility Best Practice

Why is it important to declare language in HTML?

Setting the language attribute in the HTML tag lets screen readers pronounce text correctly. Without it, assistive technologies may misidentify the language and read content incorrectly. Define language separately for any content that differs from the main site language, and ensure all system messages match your site's language.

Every web page must declare the language in which its content is written—whether Hebrew, English, or any other language. This is essential because screen readers rely on the language attribute to pronounce text correctly. When language is not clearly defined, screen readers may make mistakes, especially with languages that have similar phonetic patterns. For example, some screen readers might mistakenly identify German as English and read the text incorrectly.<\/p>\r\n

How do you set the language?<\/h4>\r\n

Language is defined using the lang<\/code> attribute in the <html><\/code> tag, for example:<\/p>\r\n

<html<\/span><\/span> lang<\/span>="en"<\/span>><\/code><\/p>\r\n

The code "en" follows the ISO 639-1 standard, which defines two-letter codes for each language. Extended four-letter codes also exist (like en-US<\/code>), but the shorter code is usually sufficient for most cases.<\/p>\r\n

If your page contains content in a different language—such as a Hebrew quote on an English site—define the language separately at the paragraph or element level:<\/p>\r\n

<p<\/span><\/span> lang<\/span>="he"<\/span>>זה משפט בעברית.<\/p<\/span><\/span>><\/code><\/p>\r\n

`Don't forget text direction<\/h4>\r\n`

On websites where content direction differs from the main site language, you should also add the CSS dir attribute to indicate text direction. For example, if your site is in English but you're including Hebrew text, the direction is right-to-left:<\/p>\r\n

<span<\/span><\/span> dir<\/span>="rtl"<\/span> lang<\/span>="he"<\/span>>Remember to set both the text direction and language attribute<\/span<\/span><\/span>><\/code><\/p>\r\n

`Keep messaging language-consistent<\/h4>\r\n`

Beyond technical setup, all messages and text on your site must match the site's language. If your site is in English, error messages, system notifications, and explanations should all be in English. Users who don't speak the alternate language won't understand the message content, which severely impacts their ability to navigate your site.<\/p>\r\n

Poor user experiences like this lead to frustration, site abandonment, and can even trigger legal concerns if accessibility failures are seen as discriminatory.<\/p>\r\n

<\/p>\r\n

<\/div>

Ready to make your site accessible?

Leave your details and we'll get back to you with a custom offer — no commitment

Setting Language in HTML: Why It Matters for Web Accessibility

Why is it important to declare language in HTML?

Did you know:

How do you set the language?<\/h4>\r\n

`Don't forget text direction<\/h4>\r\n`

`Keep messaging language-consistent<\/h4>\r\n`

Frequently asked questions

Ready to make your site accessible?

Ready to make your site accessible?

We use cookies