> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Localized Knowledge Articles

Knowledge articles are now tagged with localized BCP 47 language codes (e.g., **en-US**) instead of the root language name (e.g., **English**).

## What's new

* **BCP 47 language codes** – Articles now use BCP 47-compliant codes, so you can distinguish content for specific regions.
* **Locale-aware retrieval** – When users have a localized language tag, Ada automatically [surfaces matching localized articles](/docs/setup/languages/about-multilingual-support#knowledge-localization).
* **Region-specific Coaching** – When Coaching the AI Agent, you can pick region-specific articles by language tag (e.g., **en-US** vs. **en-GB**).
* **Create localized articles in Ada** – Author localized articles directly in Ada, tagged with the appropriate BCP 47 code.
* **Upsert localized articles via the Knowledge API** – Add or update localized articles programmatically through the [Knowledge API](../reference/knowledge/articles/bulk-upsert).

## Limitations

* **Knowledge-base integrations remain single-locale** – Integrations still sync only one locale per language. If your knowledge base has both **en-CA** and **en-US** articles, Ada will sync only one locale.
* **Limited end-user localization** – Ada cannot detect users' regions automatically. Most users will have only the root language tag (e.g., **en**). In these cases Ada searches articles from all locales for that language unless you add [availability rules](/docs/knowledge/article-management#article-rules) to narrow results.

## Why this matters

Companies serving multiple regions that share a language can now store and deliver region-specific knowledge, ensuring every user sees content that's accurate for their locale.