What is Translation Key?
A translation key is the identifier your code uses to look up a translated string. Instead of embedding copy directly, the code references a key like auth.failed, and the i18n layer resolves it against the active locale. Keys decouple code from copy: writers and translators can change text without touching source files.
There are two common naming styles. Structured keys (dashboard.stats.title) are stable and unambiguous but meaningless without context. Natural-language keys use the source text itself as the key, which Laravel supports through JSON translation files, and keep templates readable at the cost of churn when source copy changes. Laravel supports both: PHP array files for structured keys, a JSON file per locale for natural-language keys.
Whichever style you pick, consistency matters more than the choice. Mixed conventions make coverage hard to measure and duplicates hard to spot, especially once a project passes a few hundred keys.
// Structured key (lang/en/auth.php)
__('auth.failed');
// Natural-language key (lang/es.json)
// { "These credentials do not match our records.": "Estas credenciales no coinciden..." }
__('These credentials do not match our records.');