Do I need to include the country code in the locale in Flutter?
No.
However, if you want to cover more variations of the language (e.g. es-ES, es-MX, etc.), then it is required.
The same applies to script codes (e.g. zh-Hans, zh-Hant, etc.).
It should also be noted that it is a good practice to have a generic fallback language in order to avoid wrong language resolution.
// Full Chinese support for CN, TW, and HK
supportedLocales: <Locale>[
const Locale.fromSubtags(languageCode: 'zh'), // generic Chinese 'zh'
const Locale.fromSubtags(languageCode: 'zh', scriptCode: 'Hans'), // generic simplified Chinese 'zh_Hans'
const Locale.fromSubtags(languageCode: 'zh', scriptCode: 'Hant'), // generic traditional Chinese 'zh_Hant'
const Locale.fromSubtags(languageCode: 'zh', scriptCode: 'Hans', countryCode: 'CN'), // 'zh_Hans_CN'
const Locale.fromSubtags(languageCode: 'zh', scriptCode: 'Hant', countryCode: 'TW'), // 'zh_Hant_TW'
const Locale.fromSubtags(languageCode: 'zh', scriptCode: 'Hant', countryCode: 'HK'), // 'zh_Hant_HK'
],
Published Feb 1, 2023 · Last reviewed Oct 9, 2026 · Markdown version
Related Flutter internationalization questions:
- How can I include a placeholder in a localization message in Flutter?
- How can I use a different locale than the one defined for the whole Flutter app in one part of it?
- How do I detect the device language in Flutter?
- How do I fix the intl version conflict with flutter_localizations?
- How to detect unused string keys in Flutter ARB files?
- How to download localization files at runtime and use them in a Flutter app?
- How to get a localization message with a dynamic string key value in Flutter?
- How to localize Flutter app name?
- How to localize server data in Flutter?
- How to persist selected language in Flutter?
- How to programmatically change the locale in Flutter?
- How to reference string keys in Flutter without context?
- How to use localized date in Flutter?
- How to use localized number in Flutter?
- Is it possible to define a string in a Flutter ARB file that should not be translated?
- Is there a way I can translate my Flutter app for free?
- Why can't Flutter import package:flutter_gen/gen_l10n/app_localizations.dart anymore?
- Why does Flutter say the application's locale is not supported by all of its localization delegates?
- Why does Flutter throw a LocaleDataException saying the locale data has not been initialized?
- Why doesn't Flutter generate localization files?
- Why doesn't text direction change for RTL languages in Flutter?
- Why Flutter localization does not work on iOS platform?
- Why Flutter returns null for AppLocalizations.of(context)?
Flutter internationalization tutorial:
Resources
- What is Localizely?
- Getting started
- Localization workflow
- Translation editor
- Organizations
- Flutter Over-the-Air updates
- Flutter In-Context Editing
- Project branching
- Public projects
- Professional translation services
- Machine Translation
- AI Translation
- Translation Memory
- Glossary
- Tasks
- QA checks
- Reports and statistics
- Figma integration
- AWS S3 integration
- GitHub integration
- GitLab integration
- Bitbucket integration
- CLI
- Configuration file
- Supported file formats
- Universal placeholders
- Language & Country Codes
- Referral Program
- Affiliate Program
- I18N Questions
- FAQ
Free tools
- ICU message for translators
- ICU message editor
- Hreflang generator
- Hreflang checker
- JSON Flattener
- JSON Validator
- YAML Validator
- XML Validator
- CSV Validator
- Text Compare
- Text Encoding Converter
- Localization File Converter
- JSON Word Counter
- ARB Word Counter
- Translation Cost Calculator
Boring stuff
Newsletter
Copyrights 2026 © Localizely