# Application Localization: Locale Fallback Chain

A locale fallback chain with an ordered resolution list, coverage bars, and role badges, plus a trace showing a key served by the next locale.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/locale-fallback-chain
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [Localization](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/locale-fallback-chain.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-localization-locale-fallback-chain
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- npm packages: class-variance-authority, lucide-react, radix-ui
- shadcn/ui components: badge, button, progress
- Installs to: `@/components/blocks/application-pro/localization/locale-fallback-chain`

## About this block

Locale Fallback Chain shows the order a locale resolves
through when a string is missing. Three rows list the
chain for French (Canada), each with a drag handle, its
native name and tag, a coverage Progress bar, the
translated count, and a role Badge reading Requested,
Fallback, or Source. Below the list a resolution trace
follows one key, checkout.summary.title, as it misses
fr-CA, is served by fr-FR, and skips en-US, each step
marked with a Miss, Served, or Skipped Badge and an
icon.

The chain array is ordered and each row reads its
position from the index, so reordering the array
reorders the resolution. A traceBadge record maps each
result to its label and variant, and the footer states
the two rules that matter, reordering applies on the
next publish and a key missing everywhere renders its
key name in development.

## When to use

Reach for this block on the locale settings page when a
regional variant leans on a parent locale and the team
needs to see exactly what a user gets for a missing
string. Wire the chain to your resolution config and
the trace to a real lookup so the served row is not a
guess.

A natural flow around it on an Application Pro page:

**Before**

- [Locale coverage matrix](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization)
- [Translation progress card](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization)

**After**

- [Translation table](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization)
- [Settings shell](https://www.shadcn-ui-blocks.com/blocks/application-pro/app-shells)

## What you can display

One strong use is the fallback order for a regional
variant. Other fallback chain shapes:

- **Deep chain.** A four or five locale chain when a
  dialect falls back through a region to a base language.
- **Per key trace.** The trace pinned to a single key
  the support team flagged as showing the wrong locale.
- **Coverage gate view.** The chain sorted by coverage
  so the weakest fallback in the order stands out.

> Tip: read the trace top to bottom, the first Served
> row is exactly what a user sees, everything below it
> never runs.

## More in Application Localization

- [Format Settings](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/format-settings)
- [Glossary Manager](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/glossary-manager)
- [Language Switcher Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/language-switcher-blueprint)
- [Locale Coverage Matrix](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/locale-coverage-matrix)
- [Locale Preview Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/locale-preview-card)
- [Pseudo Locale Tester](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/pseudo-locale-tester)
- [RTL Preview Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/rtl-preview-panel)
- [String Editor Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/string-editor-panel)
- [Translation Progress Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/translation-progress-card)
- [Translation Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/translation-table)
