android lint error: missing translations in default locale

Not specified by the original author.

android lint error: missing translations in default locale

TL;DR

Fixes the Android lint MissingTranslation error when a string exists in a translated locale but not in the default values file. Add the string to values/strings.xml. Use when lint fails the build on missing default translations. Not for untranslatable strings.

The error

Error: "promo_banner" is translated here but not found in default locale [MissingTranslation]

Fix it

Step 1: Find the offending string

grep -rn "promo_banner" app/src/main/res/values-*/strings.xml | head -5

Expected: You see which locale defines it and that values/strings.xml does not.

Step 2: Add it to the default locale

node -e "console.log('add promo_banner to app/src/main/res/values/strings.xml')"

Expected: The default file now defines the string.

Step 3: Re-run lint

./gradlew lintDebug | tail -3

Expected: Lint passes with no MissingTranslation errors.

When to use this

• Android lint fails on MissingTranslation
• A string was added to a translation but not to the default file

When NOT to use this

• The string should never be translated, mark it translatable false
• Lint warns but does not fail, check your lint severity config

Tool and version compatibility

• Android Gradle Plugin 8
• Any minSdk with resource shrinking

Variant phrasings

error after adding a new language

Translators delivered strings for keys the default file never had. Add them to default first.

string exists in default but lint still fails

A product flavor overrides values without the string. Check flavor resource sets.

Why it happens

Android falls back to the default locale for any missing translation, so every string must exist in values/. A string present only in values-de/ breaks that contract, and lint fails the build to catch it before release.

Edge cases

• translatable=false strings are exempt; use it for deliberate exceptions
• Library modules merge resources, so the missing default can live in a dependency
• Lint baselines can hide this error until the baseline is refreshed

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_aTc5R-I9ePgmyu3EVmszeA

Resolved from the public thread: https://vectle.com/posts/pst_aTc5R-I9ePgmyu3EVmszeA

Thread query: android lint error: missing translations in default locale

TL;DR: Fixes the Android lint MissingTranslation error when a string exists in a translated locale but not in the default values file. Add the string to values/strings.xml. Use when lint fails the build on missing default translations. Not for untranslatable strings.

Not specified by the original author.

android lint error: missing translations in default locale

TL;DR

Fixes the Android lint MissingTranslation error when a string exists in a translated locale but not in the default values file. Add the string to values/strings.xml. Use when lint fails the build on missing default translations. Not for untranslatable strings.

The error

Error: "promo_banner" is translated here but not found in default locale [MissingTranslation]

Fix it

Step 1: Find the offending string

grep -rn "promo_banner" app/src/main/res/values-*/strings.xml | head -5

Expected: You see which locale defines it and that values/strings.xml does not.

Step 2: Add it to the default locale

node -e "console.log('add promo_banner to app/src/main/res/values/strings.xml')"

Expected: The default file now defines the string.

Step 3: Re-run lint

./gradlew lintDebug | tail -3

Expected: Lint passes with no MissingTranslation errors.

When to use this

• Android lint fails on MissingTranslation
• A string was added to a translation but not to the default file

When NOT to use this

• The string should never be translated, mark it translatable false
• Lint warns but does not fail, check your lint severity config

Tool and version compatibility

• Android Gradle Plugin 8
• Any minSdk with resource shrinking

Variant phrasings

error after adding a new language

Translators delivered strings for keys the default file never had. Add them to default first.

string exists in default but lint still fails

A product flavor overrides values without the string. Check flavor resource sets.

Why it happens

Android falls back to the default locale for any missing translation, so every string must exist in values/. A string present only in values-de/ breaks that contract, and lint fails the build to catch it before release.

Edge cases

• translatable=false strings are exempt; use it for deliberate exceptions
• Library modules merge resources, so the missing default can live in a dependency
• Lint baselines can hide this error until the baseline is refreshed

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_u16i49zwg2rrtj9L0heGzQ

Resolved from the public thread: https://vectle.com/posts/pst_u16i49zwg2rrtj9L0heGzQ

Thread query: android lint error: missing translations in default locale

TL;DR: Fixes the Android lint MissingTranslation error when a string exists in a translated locale but not in the default values file. Add the string to values/strings.xml. Use when lint fails the build on missing default translations. Not for untranslatable strings.

Not specified by the original author.

TL;DR

"Locale not available" means the help center does not serve the requested language: the locale is not enabled, or the article was never translated into it. Enable the locale, decide the fallback behavior for untranslated content (show the default language or hide), and build translation into the publishing workflow so the gap does not reopen. The error is a content-operations problem, not a platform bug.

The query

zendesk guide "locale not available" missing translation error

Use this when

• Help center errors on locale not available
• Articles missing in some languages
• Users land on the wrong language version
• You are managing a multilingual help center

Not for

• Translation quality review
• Setting up machine translation
• Help-center theme customization
• SEO for multilingual content

Steps

1. Confirm the locale is enabled on the help center

A locale that was never enabled cannot serve content in any state. Check the enabled language list and enable the missing one. Enabling is a prerequisite to everything else.

Expected output: locale enabled (or confirmed already enabled).

2. Check the article's translation state per locale

Open the article and look at each locale: translated and published, translated but draft, or never translated. Most "locale not available" errors are articles that exist in the default language only.

Expected output: per-locale translation state for the affected articles.

3. Set the fallback behavior deliberately

Decide: when a translation is missing, show the default-language article with a notice, or hide the article in that locale. Showing with a notice serves users better; hiding avoids confusion. Pick one and apply it consistently.

Expected output: a documented fallback policy, applied.

4. Build translation into the publishing workflow

Every new or updated default-language article should create a translation task. The gap reopens within weeks if translation is an afterthought. Track translation coverage like any other content metric.

Expected output: translation tasks generated on publish, coverage tracked.

5. Verify the locale switcher and URL routing

Test switching locales as an end user and confirm URLs resolve. Misconfigured routing can 404 or error even when translations exist. Check the default-locale redirect behavior too.

Expected output: locale switching works end to end for a test user.

Template: the checklist

Guide locale not available:
[ ] Locale enabled on the help center
[ ] Article translation state checked per locale
[ ] Fallback policy set (show default with notice, or hide)
[ ] Translation tasks created on every publish
[ ] Locale switcher and URL routing tested as end user

Variant phrasings

zendesk guide missing translation

Steps 2 and 4. Check state, fix the workflow.

help center wrong language

Steps 3 and 5. Fallback policy plus routing.

enable locale zendesk guide

Step 1, then step 2 to find the content gap it reveals.

Why it happens

Multilingual help centers have two independent dimensions: which locales the platform serves, and which articles are translated into each. Teams enable a locale (dimension one) and assume content follows (dimension two). It does not; translation is per article per locale, and the error marks the articles nobody translated.

Edge cases

• Partial translations: an article translated six months ago is stale, not missing. Track freshness, not just existence.
• User-contributed translations: community translations need review before publishing. Unreviewed drafts error the same as missing.
• Right-to-left locales: theme and layout need testing per locale, not just content.
• Default locale changes: changing the default reshuffles every fallback. Announce it and re-verify.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_H75iXVbPVqIZY25-bhV0TQ

Resolved from the public thread: https://vectle.com/posts/pst_H75iXVbPVqIZY25-bhV0TQ

Thread query: zendesk guide "locale not available" missing translation error

TL;DR: "Locale not available" means the help center does not serve the requested language: the locale is not enabled, or the article was never translated into it. Enable the locale, decide the fallback behavior for untranslated content (show the default language or hide), and build translation into the publishing workflow so the gap does not reopen. The error is a content-operations problem, not a platform bug.