SuperAPI AI Directory

duo-localization

General & other

View repository

Updated 10-15 22:13

About this skill

Duolingo Localization — Map of Content

Translation is the cheapest and least important part of shipping to a market that is not yours. The expensive parts are structural: components that encode a reading direction, containers sized for your source string, defaults that decide who sees what, and copy that works through connotation rather than meaning. Most localization failures are not mistranslations — they are correct strings inside a product that still assumes your user.

Two ideas run through all of it. First, comprehension beats correctness — the goal is the user reaching the next screen, not a string a reviewer would approve. Second, the market you learned your product in taught you things that are not true elsewhere, so every default, every winning test and every cohort assumption is suspect until re-checked locally.

Scan the descriptions, follow only the [[wikilinks]] you need.

Write for the person who is actually reading

  • [[references/localize-into-the-register-people-speak]] — ship the words users say, including loanwords; review every screen against your least software-fluent user; open by inventorying what they already know.
  • [[references/rewrite-rather-than-default-the-assumption]] — when grammar forces you to assert something about the user, rephrase around it rather than picking a default, and prefer already-neutral words to invented ones.
  • [[references/localize-to-a-consumption-budget]] — the constraint is the consumer's processing rate, so rank information by importance and preserve intent rather than words.

The product, not the strings

  • [[references/reading-direction-is-a-component-problem]] — pagers, swipes and orderings encode direction; the platform primitive you need may never have been fixed, so budget to build it.
  • [[references/layout-overrides-your-content-policy]] — containers sized for the source string quietly revert your content decisions, and a denser script can buy explanation that a longer one cannot.

Read your own market signals with suspicion

  • [[references/device-locale-is-not-intent]] — device language describes a phone, not a person; popularity rankings mostly measure what you put on the shelf.
  • [[references/a-winning-message-is-valid-only-where-it-won]] — persuasion, cohort shape and even where your audience lives are local facts; re-test before rolling a localized win out.

Who owns the words

  • [[references/local-teams-own-expressive-copy-and-full-editions]] — give regional teams authority to diverge from the source for names, campaigns and story, and publish flagship material complete in-language.

Boundary

This skill covers what has to change inside the product once you are in a market. Barriers a third party controls — carrier data costs, accreditation, institutional procurement, app-store policy — are a distribution problem and belong elsewhere. Accessibility and the requirements that exclude people regardless of locale live in [[../duo-inclusive-access/SKILL]]. And pixel craft — easing values, contrast ratios, token values, component props — is out of scope for this whole pack; route it per [[../duolingo/references/design-handoff]].

Sibling skills

  • [[../duo-voice/SKILL]] — the brand voice that expressive copy has to carry into each market.
  • [[../duo-experimentation/SKILL]] — how to re-test a localized win without fooling yourself, including what a null result is worth.
  • [[../duo-inclusive-access/SKILL]] — the requirements that filter people out on circumstance rather than ability.
  • [[../duo-growth/SKILL]] — choosing which market to open, and what earned media a localized launch buys.

Sources

Distilled from 15 posts on blog.duolingo.com dated 2016-09-13 to 2026-07-07, all cited inline and dated in each node; slugs are verified against scripts/sources.json.