--- title: "How to route QR code visitors by their phone's language" description: "Add a Language condition to a QR code or link: each visitor goes down the branch of the language their phone or browser is set to, French to the French page, Spanish to the Spanish one, everyone else to a fallback. Works on the first scan, on every plan." canonical: "https://linkbreakers.com/help/article/how-to-route-qr-code-visitors-by-their-phones-language" last-updated: 2026-10-30 --- # How to route QR code visitors by their phone's language > Add a Language condition to a QR code or link: each visitor goes down the branch of the language their phone or browser is set to, French to the French page, Spanish to the Spanish one, everyone else to a fallback. Works on the first scan, on every plan. :::try-ai-prompt {"prompt":"Add a language condition after the scan: phones set to French go to example.com/fr, phones set to Spanish go to example.com/es, and everyone else goes to example.com/en.","description":"Try building language routing with the AI builder."}::: ## Short answer To send each visitor to the page in their own language, add a **Language condition** to the link's workflow. Linkbreakers reads the first language the visitor's phone or browser asks for and sends them down that language's branch. Each language covers all its regional variants: **French** catches French from France, Canada, Belgium and Switzerland. Visitors whose language is not listed, or whose phone sends none, take the **Other languages** branch. It works on the very first scan, adds no delay and asks nothing of the visitor. It is available on every plan. ## Quick summary - One branch per language you add, plus **Other languages** for everyone else. - Languages are matched on their two-letter code (ISO 639-1): `fr`, `es`, `de`, `pt`, `zh`, and so on. Regional variants (`fr-CA`, `pt-BR`, `zh-TW`) fall into their language's branch. - The language is the one the phone or browser puts first, the same setting that picks the language of websites. - Each visit's activity timeline shows the language detected and the branch it took. Slack notifications show it as **Language Routing**. - Also available through the API, the MCP server, the CLI, the SDKs and the Assistant. ## Why language rather than country A [country condition](https://linkbreakers.com/help/article/how-to-use-country-conditions) routes on where the visitor is. A language condition routes on what they read. They often differ: - A tourist from Spain scanning a museum label in Paris is in France but reads Spanish. - Canada, Belgium and Switzerland have more than one language, so the country alone cannot pick the page. - A visitor on a VPN appears in the wrong country, but their phone's language stays the same. When the question is "which version of the page should this person read?", use a language condition. When it is about the place, such as local prices, legal notices or the nearest store, use a country condition. They can be chained: country first, then language within it. ## Step-by-step 1. Go to [Links](https://app.linkbreakers.com/workspace/dashboard/links) and open the QR code or link. Its workflow opens. 2. Click the **+** button on the connector where you want the routing, usually right after the scan. 3. In the condition steps, choose **Language Condition**. 4. Pick a language in the list, then **Add Language** for each other one you want a branch for. 5. Click **Create Language Condition**. The step appears on the canvas with one outlet per language and an **Other languages** outlet. 6. Connect each outlet to its next step: a redirect to that language's page, a form in that language, a multi-link page, or anything else. 7. Connect **Other languages** too. Visitors it catches have nowhere to go otherwise and fall back to the link's fallback URL. To check it, change your phone's language (or your browser's preferred language on a computer) and scan again. ## Examples ### A menu or a label in several languages A restaurant prints one QR code per table. French phones get the French menu PDF, English phones the English one, and **Other languages** the English one too. ### Packaging sold in several markets One pack sold in Canada leads French phones to the French instructions and everyone else to the English ones, whatever province they are in. ### Events with international visitors A trade show badge QR code sends German, Spanish and Italian phones to the exhibitor page in their language, and the rest to the English page. ## Set it up from an AI agent With the [MCP server](https://linkbreakers.com/help/article/mcp-server-setup) connected, or in the Assistant, ask: > Add a language condition right after the scan of my "Spring menu" link: French phones to the French menu, Spanish phones to the Spanish one, everyone else to the English menu. The step is `LANGUAGE_CONDITION`, with a list of `languages` (`language_code`, lowercase ISO 639-1) and an `else_next_step_id`. Each branch is addressed by its language code, and the fallback by `else`, through the same workflow step tools as every other condition. ## Limits and caveats - **The first language only.** A phone set to "English, then French" is routed as English. Visitors rarely change this order, and it is the one websites use too. - **Base language only.** There is no separate branch for `pt-BR` and `pt-PT`. To tell regions apart, chain a country condition after the language one. - **What the phone says, not what the visitor reads best.** Someone who set their phone to English but prefers Spanish is routed as English. Keep a language switch on your pages. - **No language sent.** Some apps' in-app browsers and some bots send no language. They take **Other languages**. ## Frequently asked questions ### Does it slow down the scan? No. The language comes with the visit itself, so the routing happens on the redirect with nothing to wait for. ### Does it work on the first scan? Yes. It reads the visit's own request, not a profile built from earlier visits. ### Can I route several languages to the same page? Yes. Connect their outlets to the same next step. ### Which languages are available? Every language with a two-letter ISO 639-1 code, about 180 of them, from Arabic and Chinese to Welsh and Zulu. ### Can I combine it with other conditions? Yes. Place it before or after a country, device, schedule or visitor data condition, like any other step. ## Last reviewed 2026-10-30 by Laurent Schaffner.