Translations

Home Assistant is available in 64 languages, and every one of them is translated by people who use it. When someone in Brazil, Japan, or Finland opens Home Assistant for the first time, the words they see were written by a volunteer like you.

You do not need to know how to code to help. If you are a native speaker and you care about how your language reads, you have everything it takes.

There are two kinds of translation work, and they use different tools:

• Interface text is everything you read on screen: menus, settings, dialogs, error messages, and the names of entities and their states. You translate it in your browser, on Lokalise.
• Voice commands are the sentences Home Assistant understands when you talk to Assist, and the answers it gives back. They live in YAML files on GitHub, and language leaders review the changes for their language. See Voice.

Most people start with interface text. It takes a few minutes to get going, and what you translate ships without a review step, see how translations get back.

• Your first translation: set up an account and translate your first strings.
• How translation works: where the strings come from, and how your work ends up in Home Assistant.

• Placeholders and references: the parts of a string you should not translate, and why.
• Request a new language: when your language is missing.
• Make your strings translatable: for developers adding text to Home Assistant.

• Voice: help Assist understand your language, with the sentences it recognizes and the answers it gives.
• Contribute sentences and responses: your first change in the intents repository.
• Built-in intents: every intent, with its slots.

• Translation rules: the rules that apply to every language.
• Language guidelines: agreements made per language, written in that language.
• Brand: the personality and voice of Home Assistant, and how to write its name.

• Questions about a specific string? Leave a comment on it in Lokalise. Other translators of your language see it there.
• Missing a language, or want to discuss how translation works? Use the localization discussions on GitHub.
• Working on voice commands? The intents discussions are the place, and the language leader of your language reviews your changes. Language leaders meet in the #language-leaders channel on the Home Assistant Discord.