npm · #4793 most downloaded on npm

@intlify/shared

11.4.13intlify/vue-i18n ↗New releases in your daily digest, changelog included.

@intlify/shared

Last release 2 days ago
02 Oct 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
216 releases · first in 2020

Release timeline

216 releases since 2020

2020202120222023202420252026

20202026

One column per quarter.

Releases

12.0.0-alpha.417 May 2026pre-releaseSecurity
fix: backport CVE-2025-53892 (escapeParameterHtml DOM XSS hardening) to master by @vulgraph in #2470
What's Changed

🌟 Features

Part options support for $n by @mauryapari in #2170

feat: Part options support $d by @mauryapari in #2177

feat: compatible Vue3 vapor mode by @kazupon in #2299

feat(message-compiler): support escape sequence by @kazupon in #2394

feat!: Support automatic pluralization with Intl.PluralRules by @kazupon in #2400

feat: support isolated scope by @kazupon in #2404

🐛 Bug Fixes

fix: cannot resolve the ast messages which has json path by @kazupon in #2157

fix(typing): n() & d() output depending "part" option by @pinguet62 in #2193

Fix declaration order in Number formatting with options ResourceKeys must be before OptionsType by @louis49 in #2205

Fix: Adjust stub file paths for accurate resolution during rolldown build by @babu-ch in #2217

fix: revert vue devtools timeline listening code by @kazupon in #2359

fix(core-base): throw error when has string prototype key by @kazupon in #2402

fix(core-base): key paths containing javascript built-ins are handled inconsistently by @kazupon in #2403

fix: wrong $d type by @kazupon in #2405

fix: export conditions for node.js by @kazupon in #2408

fix: te returns false if the key contains a do by @kazupon in #2409

fix: modifiers skip missing translation keys by @kazupon in #2412

fix: Numeric named parameter overwrites plural parameter in pluralization by @kazupon in #2413

fix: Suppressing automatic locale fallback with ! breaks n/$n and d/$d formatting by @kazupon in #2418

fix: Resource Keys completion does not work with global messages and $t by @kazupon in #2421

fix: $n overloads use DefineNumberFormat instead of DefineDateTimeFormat by @babu-ch in #2459

fix: linked messages fail to resolve keys containing dots by @babu-ch in #2458

fix: backport CVE-2025-53892 (escapeParameterHtml DOM XSS hardening) to master by @vulgraph in #2470

💥 Breaking Changes

breaking: update component injection APIs for drop legacy by @kazupon in #2176

breaking: change MissingHandler 2nd parameter by @kazupon in #2358

breaking: deprecate register* global functions in favor of createI18n options by @kazupon in #2445

chore!: drop Node.js 20 support by @kazupon in #2487

⚡ Improvement Features

fix: update slot key filtering to exclude internal keys by @edison1105 in #2167

fix: improvement n and $n typings by @kazupon in #2174

Named, list, modifier examples by @mauryapari in #2186

fix: error on duplicate useI18n calling on local scope by @kazupon in #2204

fix: typo by @kazupon in #2222

Emit INVALID_TOKEN_IN_PLACEHOLDER on invalid palceholder token by @lutejka in #2252

fix: include vitest/node types to fix Vitest 4 type errors by @haoqunjiang in #2303

fix: useI18n implementation with provide-inject fully by @kazupon in #2357

refactor: reduce variable assignments and function calls by @BobbieGoede in #2392

fix: display message commpiler error strictly by @kazupon in #2410

fix: te function returns false although fallback exists by @kazupon in #2416

fix: Usage of n() and $n() with undefined should not throw errors by @kazupon in #2417

docs: add possible errors for number/datetime formatter APIs by @mitre88 in #2424

fix(i18n-t): pass component children as slots by @kazupon in #2475

🔒 Security Fixes

security(ci): harden workflows and add zizmor audit by @kazupon in #2489

📈 Performance Fixes

perf: use shallowRef server-side for datetimeFormats by @BobbieGoede in #2333

fix: enable the minify selecting option by @kazupon in #2356

📝️ Documentations

Fix typos in CHANGELOG by @NoelDeMartin in #2151

docs: llms friendly text generation by @kazupon in #2168

docs: fix typo in pluralization.md by @KonRatt in #2184

docs: replace Legacy API usage with Composition API usage by @BobbieGoede in #2196

Update StackBlitz link in getting started guide by @babu-ch in #2218

docs: update v8 docs links to point to legacy site by @babu-ch in #2227

docs: Add SSR configuration guide for vue-i18n plugin by @babu-ch in #2262

Update component.md to explain it doesn't work in petite vue by @riderx in #2259

docs: fix typos in docs by @kianmeng in #2279

docs: add Chinese and Japanese documentation translations by @fonghehe in #2390

fix typoes, broken rt link by @Nikita0x in #2393

docs: update v12 migration guide by @kazupon in #2395

docs: add v11 pages by @kazupon in #2396

docs: revise docs for v12 by @kazupon in #2397

docs: fix wrong plural usage by @kazupon in #2401

docs: improve petite-vue-i18n resource key handling by @kazupon in #2414

docs: improve unplugin-vue-i18n options explanation by @kazupon in #2419

docs: more details for availableLocales by @kazupon in #2420

🍭 Examples

examples: Storybook Example with vue3 and vite by @mauryapari in #2173

New Contributors

@NoelDeMartin made their first contribution in #2151

@edison1105 made their first contribution in #2167

@KonRatt made their first contribution in #2184

@louis49 made their first contribution in #2205

@kitsiosk made their first contribution in #2226

@autologie made their first contribution in #2228

@lutejka made their first contribution in #2252

@riderx made their first contribution in #2259

@kianmeng made their first contribution in #2279

@kbegiedza made their first contribution in #2282

@haoqunjiang made their first contribution in #2303

@fonghehe made their first contribution in #2390

@Nikita0x made their first contribution in #2393

@mitre88 made their first contribution in #2424

@vulgraph made their first contribution in #2470

Full Changelog: v12.0.0-alpha.2...v12.0.0-alpha.4

12.0.0-alpha.32 Jul 2025pre-release

What's Changed

🌟 Features

Part options support for $n by @mauryapari in https://github.com/intlify/vue-i18n/pull/2170
feat: Part options support $d by @mauryapari in https://github.com/intlify/vue-i18n/pull/2177

🐛 Bug Fixes

fix: cannot resolve the ast messages which has json path by @kazupon in https://github.com/intlify/vue-i18n/pull/2157
fix(typing): n() & d() output depending "part" option by @pinguet62 in https://github.com/intlify/vue-i18n/pull/2193
Fix declaration order in Number formatting with options ResourceKeys must be before OptionsType by @louis49 in https://github.com/intlify/vue-i18n/pull/2205

💥 Breaking Changes

breaking: update component injection APIs for drop legacy by @kazupon in https://github.com/intlify/vue-i18n/pull/2176

⚡ Improvement Features

fix: update slot key filtering to exclude internal keys by @edison1105 in https://github.com/intlify/vue-i18n/pull/2167
fix: improvement n and $n typings by @kazupon in https://github.com/intlify/vue-i18n/pull/2174
Named, list, modifier examples by @mauryapari in https://github.com/intlify/vue-i18n/pull/2186
fix: error on duplicate useI18n calling on local scope by @kazupon in https://github.com/intlify/vue-i18n/pull/2204

📝️ Documentations

Fix typos in CHANGELOG by @NoelDeMartin in https://github.com/intlify/vue-i18n/pull/2151
docs: llms friendly text generation by @kazupon in https://github.com/intlify/vue-i18n/pull/2168
docs: fix typo in pluralization.md by @KonRatt in https://github.com/intlify/vue-i18n/pull/2184
docs: replace Legacy API usage with Composition API usage by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/2196

🍭 Examples

examples: Storybook Example with vue3 and vite by @mauryapari in https://github.com/intlify/vue-i18n/pull/2173

New Contributors

@NoelDeMartin made their first contribution in https://github.com/intlify/vue-i18n/pull/2151
@edison1105 made their first contribution in https://github.com/intlify/vue-i18n/pull/2167
@KonRatt made their first contribution in https://github.com/intlify/vue-i18n/pull/2184
@louis49 made their first contribution in https://github.com/intlify/vue-i18n/pull/2205

Full Changelog: https://github.com/intlify/vue-i18n/compare/v12.0.0-alpha.2...v12.0.0-alpha.3

Open source →

12.0.0-alpha.220 Mar 2025pre-release

What's Changed

🐛 Bug Fixes

fix: ESM only with package.json type field by @kazupon in https://github.com/intlify/vue-i18n/pull/2141

Full Changelog: https://github.com/intlify/vue-i18n/compare/v12.0.0-alpha.1...v12.0.0-alpha.2

Open source →

12.0.0-alpha.117 Mar 2025pre-release

What's Changed

🌟 Features

feat: reactive availableLocales using computed property by @mnenie in https://github.com/intlify/vue-i18n/pull/2058
feat: configurable ComponentCustomProperties['$i18n'] type by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/2093
feat(core-base): accessor for locale messages by @kazupon in https://github.com/intlify/vue-i18n/pull/2135

🐛 Bug Fixes

Fix: Synchronous Watcher Issue Caused by Locale Setting Order by @lcjnil in https://github.com/intlify/vue-i18n/pull/2104

💥 Breaking Changes

breaking: drop custom directive v-t by @kazupon in https://github.com/intlify/vue-i18n/pull/2061
feat!: change to mangle option name from minify option name by @kazupon in https://github.com/intlify/vue-i18n/pull/2064
drop node v18 by @babu-ch in https://github.com/intlify/vue-i18n/pull/2109
drop Legacy API by @babu-ch in https://github.com/intlify/vue-i18n/pull/2110
ship ESM only by @babu-ch in https://github.com/intlify/vue-i18n/pull/2112

⚡ Improvement Features

fix: update MountOptions.components type by @johnsoncodehk in https://github.com/intlify/vue-i18n/pull/2128

📈 Performance Fixes

perf: more optimize bundle size by @kazupon in https://github.com/intlify/vue-i18n/pull/2065

📝️ Documentations

docs: API reference for multi version preparation by @kazupon in https://github.com/intlify/vue-i18n/pull/2059
fix(installation.md): update installation commands for package manager by @Vincere1st in https://github.com/intlify/vue-i18n/pull/2081
Update introduction.md by @ismailsabet in https://github.com/intlify/vue-i18n/pull/2095
Update CONTRIBUTING.md by @babu-ch in https://github.com/intlify/vue-i18n/pull/2111
docs: clarify v-t limitations and reactivity behavior by @docnoe in https://github.com/intlify/vue-i18n/pull/2118

New Contributors

@mnenie made their first contribution in https://github.com/intlify/vue-i18n/pull/2058
@Vincere1st made their first contribution in https://github.com/intlify/vue-i18n/pull/2081
@ismailsabet made their first contribution in https://github.com/intlify/vue-i18n/pull/2095
@lcjnil made their first contribution in https://github.com/intlify/vue-i18n/pull/2104
@babu-ch made their first contribution in https://github.com/intlify/vue-i18n/pull/2109
@johnsoncodehk made their first contribution in https://github.com/intlify/vue-i18n/pull/2128

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.0.1...v12.0.0-alpha.1

Open source →

11.4.132 Oct 2026

fix(core-base): map locale unions without the UnionToTuple round-trip by @kazupon in #2651

What's Changed

⚡ Improvement Features

fix(core-base): map locale unions without the UnionToTuple round-trip by @kazupon in #2651

Full Changelog: v11.4.12...v11.4.13

Open source →

11.4.1216 Sept 2026

fix(core-base): cache locale chains by fallback identity by @kazupon in #2635

What's Changed

🐛 Bug Fixes

fix(core-base): cache locale chains by fallback identity by @kazupon in #2635
fix(vue-i18n-core): sync the core context when inheritLocale is enabled by @kazupon in #2636

Full Changelog: v11.4.10...v11.4.12

Open source →

11.4.1025 Aug 2026

fix(core-base): avoid throwing on AST keys in devtools groupId by @kazupon in #2603

What's Changed

🐛 Bug Fixes

fix(core-base): avoid throwing on AST keys in devtools groupId by @kazupon in #2603

Full Changelog: v11.4.9...v11.4.10

Open source →

11.4.923 Aug 2026

fix(core-base): invalidate locale chain cache when fallback changes by @kazupon in #2577

What's Changed

🐛 Bug Fixes

fix(core-base): invalidate locale chain cache when fallback changes by @kazupon in #2577
fix(core-base): fallbackWithSimple uses map keys and skips default by @kazupon in #2580

⚡ Improvement Features

fix(vue-i18n-core): preserve tree-shaking with Vapor by @kazupon in #2578
fix(shared): avoid retaining array message references by @Togetic in #2571

👕 Refactoring

chore(release): generate changelog in the tagged commit by @kazupon in #2590

Full Changelog: v11.4.8...v11.4.9

Open source →

11.4.826 Jul 2026

refactor: extract security sanitizer module by @kazupon in #2555

What's Changed

👕 Refactoring

refactor: extract security sanitizer module by @kazupon in #2555
refactor: unify intl formatting pipeline by @kazupon in #2556

Full Changelog: v11.4.7...v11.4.8

Open source →

11.4.720 Jul 2026

Full Changelog : v11.4.6...v11.4.7

Full Changelog: v11.4.6...v11.4.7

Open source →

11.4.618 Jun 2026

Full Changelog : v11.4.5...v11.4.6

Full Changelog: v11.4.5...v11.4.6

Open source →

11.4.55 Jun 2026

fix(core-base): respect part option when format key is omitted in number / datetime by @kazupon in #2522

What's Changed

⚡ Improvement Features

fix(core-base): respect part option when format key is omitted in number/datetime by @kazupon in #2522

Full Changelog: v11.4.4...v11.4.5

Open source →

11.4.418 May 2026

fix(security): harden javascript URL sanitization by @kazupon in #2503

What's Changed

⚡ Improvement Features

fix(security): harden javascript URL sanitization by @kazupon in #2503

Full Changelog: v11.4.3...v11.4.4

Open source →

11.4.317 May 2026

chore!: drop Node.js 20 support by @kazupon in #2478

What's Changed

💥 Breaking Changes

chore!: drop Node.js 20 support by @kazupon in #2478

🔒 Security Fixes

security(ci): harden workflows and add zizmor audit by @kazupon in #2490

Full Changelog: v11.4.2...v11.4.3

Open source →

11.4.27 May 2026

fix(formatter): pass component children as slots by @kazupon in #2474

What's Changed

⚡ Improvement Features

fix(formatter): pass component children as slots by @kazupon in #2474

Full Changelog: v11.4.1...v11.4.2

Open source →

11.4.17 May 2026

fix(i18n-t): pass component children as slots by @kazupon in #2473

What's Changed

⚡ Improvement Features

fix(i18n-t): pass component children as slots by @kazupon in #2473

Full Changelog: v11.4.0...v11.4.1

Open source →

11.4.024 Apr 2026

What's Changed

🌟 Features

feat: support isolated scope by @kazupon in https://github.com/intlify/vue-i18n/pull/2468

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.3.2...v11.4.0

Open source →

11.3.28 Apr 2026

What's Changed

🐛 Bug Fixes

fix(core): avoid register* functions tree-shaking for intlify/core by @kazupon in https://github.com/intlify/vue-i18n/pull/2464

⚡ Improvement Features

perf(core-base): avoid translation timeline measurement without devtools by @kazupon in https://github.com/intlify/vue-i18n/pull/2465

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.3.1...v11.3.2

Open source →

11.3.16 Apr 2026

What's Changed

🐛 Bug Fixes

fix: linked messages fail to resolve keys containing dots by @kazupon in https://github.com/intlify/vue-i18n/pull/2460
fix: $n overloads use DefineNumberFormat instead of DefineDateTimeFormat by @kazupon in https://github.com/intlify/vue-i18n/pull/2461

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.3.0...v11.3.1

Open source →

11.3.07 Mar 2026

What's Changed

🌟 Features

feat: support escape sequence by @kazupon in https://github.com/intlify/vue-i18n/pull/2437

🐛 Bug Fixes

fix: wrong @intlify/devtools-types dependencies by @kazupon in https://github.com/intlify/vue-i18n/pull/2411
fix: v-t directive does not rerender when locale switches by @kazupon in https://github.com/intlify/vue-i18n/pull/2415
fix: te returns false if the key contains a do by @kazupon in https://github.com/intlify/vue-i18n/pull/2430
fix: modifiers skip missing translation keys by @kazupon in https://github.com/intlify/vue-i18n/pull/2432
fix: wrong $d type by @kazupon in https://github.com/intlify/vue-i18n/pull/2435
fix: resolve correctly key path by @kazupon in https://github.com/intlify/vue-i18n/pull/2436

⚡ Improvement Features

fix: Usage of n() and $n() with undefined should not throw errors by @kazupon in https://github.com/intlify/vue-i18n/pull/2429
fix: display message commpiler error strictly by @kazupon in https://github.com/intlify/vue-i18n/pull/2431
fix: Suppressing automatic locale fallback with ! breaks n/$n and d/$d formatting by @kazupon in https://github.com/intlify/vue-i18n/pull/2434

📈 Performance Fixes

perf: use shallowRef server-side for datetimeFormats by @kazupon in https://github.com/intlify/vue-i18n/pull/2428

📝️ Documentations

docs: fix wrong plural usage by @kazupon in https://github.com/intlify/vue-i18n/pull/2438
docs: improve petite-vue-i18n resource key handling by @kazupon in https://github.com/intlify/vue-i18n/pull/2439

👕 Refactoring

refactor: reduce variable assignments and function calls by @kazupon in https://github.com/intlify/vue-i18n/pull/2426

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.2.8...v11.3.0

Open source →

11.2.831 Dec 2025

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.2.7...v11.2.8

Open source →

11.2.721 Dec 2025

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.2.6...v11.2.7

Open source →

11.2.621 Dec 2025

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.2.5...v11.2.6

Open source →

11.2.226 Nov 2025

What's Changed

🐛 Bug Fixes

fix: avoid bundler static analysis for namespace import by @kazupon in https://github.com/intlify/vue-i18n/pull/2326

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.2.1...v11.2.2

Open source →

11.2.122 Nov 2025

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.2.0...v11.2.1

Open source →

11.1.125 Sept 2025

What's Changed

⚡ Improvement Features

fix: Emit INVALID_TOKEN_IN_PLACEHOLDER instead of UNTERMINATED_CLOSING_BRACE when invalid token is in placeholder and update docs by @kazupon in https://github.com/intlify/vue-i18n/pull/2255

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.11...v11.1.12

Open source →

11.1.1123 Jul 2025

What's Changed

⚡ Improvement Features

fix: change warning from error for mutiple useI18n local scope calling by @kazupon in https://github.com/intlify/vue-i18n/pull/2235

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.10...v11.1.11

Open source →

11.1.1016 Jul 2025

🔒 Security Fixes

fix: DOM-based XSS via tag attributes for escape parameter, about details see https://github.com/intlify/vue-i18n/security/advisories/GHSA-x8qp-wqqm-57ph

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.9...v11.1.10

Open source →

11.1.93 Jul 2025

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.8...v11.1.9

Open source →

11.1.82 Jul 2025

What's Changed

⚡ Improvement Features

fix: typo by @kazupon in https://github.com/intlify/vue-i18n/pull/2221

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.7...v11.1.8

Open source →

11.1.722 Jun 2025

What's Changed

🐛 Bug Fixes

fix: declaration order in Number formatting with options ResourceKeys by @kazupon in https://github.com/intlify/vue-i18n/pull/2208

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.6...v11.1.7

Open source →

11.1.617 Jun 2025

What's Changed

⚡ Improvement Features

fix: error on duplicate useI18n calling on local scope by @kazupon in https://github.com/intlify/vue-i18n/pull/2203

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.5...v11.1.6

Open source →

11.1.527 May 2025

What's Changed

🐛 Bug Fixes

fix: n() & d() output depending "part" option by @kazupon in https://github.com/intlify/vue-i18n/pull/2194

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.4...v11.1.5

Open source →

11.1.424 May 2025

What's Changed

🌟 Features

feat: Part options support $n by @mauryapari in https://github.com/intlify/vue-i18n/pull/2175
feat: Part options support $d by @mauryapari in https://github.com/intlify/vue-i18n/pull/2180

⚡ Improvement Features

fix: support vue core internal slot key changing by @kazupon in https://github.com/intlify/vue-i18n/pull/2190

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.3...v11.1.4

Open source →

11.1.35 Apr 2025

What's Changed

🐛 Bug Fixes

fix: cannot resolve the ast messages which has json path for v11 by @kazupon in https://github.com/intlify/vue-i18n/pull/2159

⚡ Improvement Features

fix: duplicate generated type config naming by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/2158

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.2...v11.1.3

Open source →

11.1.27 Mar 2025

What's Changed

🔒 Security Fixes

fix: prototype pollution in handleFlatJson, about details see https://github.com/intlify/vue-i18n/security/advisories/GHSA-p2ph-7g93-hw3m

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.1...v11.1.2

Open source →

11.1.19 Feb 2025

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.0...v11.1.1

Open source →

11.1.031 Jan 2025

What's Changed

🌟 Features

feat: configurable ComponentCustomProperties['$i18n'] type by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/2094

📝️ Documentations

fix: vue-i18n v8 EOL by @kazupon in https://github.com/intlify/vue-i18n/pull/2060

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.0.1...v11.1.0

Open source →

11.0.126 Dec 2024

What's Changed

⚡ Improvement Features

fix: v-t custom directive warning when it will run by @kazupon in https://github.com/intlify/vue-i18n/pull/2057

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.0.0...v11.0.1

Open source →

11.0.024 Dec 2024Security

fix: security vulnerability fix porting by @kazupon in https://github.com/intlify/vue-i18n/pull/2034

We are excited to announce the release of Vue I18n v11. We had many contributors.

Thanks for your contributing ❤️

Summary

Deprecate Legacy API mode

The Legacy API mode was the API mode compatible with v8 for Vue 2. When v9 was released, the Legacy API was provided to smooth the migration from v8 to v9.

Legacy API mode will be deprecated in v11, as previous vue-i18n releases have already provided the following to support migration to Composition API mode

Migration from Legacy API mode to Composition API mode, see the docs
Composition API usage, see the docs

For compatibility, Legacy API mode still works in v11, but will be removed entirely in v12, so Legacy API mode will not work after that version.

Deprecate Custom Directive `v-t`

The advantage of v-t was that it could optimize performance using the vue compiler transform and the pre-translation of vue-i18n-extension.

This feature was supported from Vue 2. About details see the blog article

In Vue 3, due to the Composition API, the pre-translation of vue-i18n-extension is now limited only for global scope.

In addition, Vue 3 Virtual DOM optimization has been introduced, and the optimization provided by vue-i18n-extension is no longer very effective. We need to require settings for SSR, the benefits of using v-t have disappeared. And DX of templates using v-t is not good. Custom directives do not work with key completion in editors (e.g. vscode).

For compatibility, v-t mode still works in v11, but will be removed entirely in v12, so v-t will not work after that version.

Drop `tc` and `$tc` for Legacy API mode

These APIs had already deprecated in warning about being dropped in v11. docs says

Vue I18n maintenance Status

Vue I18n v8 is no longer supported after 2025. Vue I18n v9 and Vue I18n v10 is in maintenance mode after 2025 July.

With the release of Vue I18n v11, that version will become mainstream.

The maintenance detail status of Vue I18n v9 and Vue I18n v10 is as follows:

You can check the maintenance status on the docs

❗ Braeking Changes

feat!: deprecate Legacy API mode by @kazupon in https://github.com/intlify/vue-i18n/pull/2016
breaking: drop $tc and tc by @kazupon in https://github.com/intlify/vue-i18n/pull/2017
feat!: deprecate v-t custom directive by @kazupon in https://github.com/intlify/vue-i18n/pull/2045

⚡ Improvement Features

fix: tm function should accept DefineLocaleMessage key type by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/2014

🔒 Security Fixes

fix: security vulnerability fix porting by @kazupon in https://github.com/intlify/vue-i18n/pull/2034

📝️ Documentations

Change config prop for quasar flags by @chrissyast in https://github.com/intlify/vue-i18n/pull/2003
docs: Pluralization Page by @Sammuel09 in https://github.com/intlify/vue-i18n/pull/1998
docs: fix composition section by @Sammuel09 in https://github.com/intlify/vue-i18n/pull/2008
fix(docs): correct output in composition api example by @pejeio in https://github.com/intlify/vue-i18n/pull/2012
docs: not use deprecated api by @kazupon in https://github.com/intlify/vue-i18n/pull/2013
docs: fix wrong plural example by @kazupon in https://github.com/intlify/vue-i18n/pull/2033
docx(pluralization.md): Correct spelling from 'gloal' to 'global' by @PuppyOne in https://github.com/intlify/vue-i18n/pull/2038
Fix typo by @shaedrich in https://github.com/intlify/vue-i18n/pull/2040
Fix another typo by @shaedrich in https://github.com/intlify/vue-i18n/pull/2041
docs: add maintenance status by @kazupon in https://github.com/intlify/vue-i18n/pull/2044

👋 New Contributors

@chrissyast made their first contribution in https://github.com/intlify/vue-i18n/pull/2003
@Sammuel09 made their first contribution in https://github.com/intlify/vue-i18n/pull/1998
@pejeio made their first contribution in https://github.com/intlify/vue-i18n/pull/2012
@PuppyOne made their first contribution in https://github.com/intlify/vue-i18n/pull/2038
@shaedrich made their first contribution in https://github.com/intlify/vue-i18n/pull/2040

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.4...v11.0.0

Open source →

11.0.0-rc.119 Dec 2024pre-releaseDeprecated

feat!: deprecate v-t custom directive by @kazupon in https://github.com/intlify/vue-i18n/pull/2045

What's Changed

💥 Breaking Changes

feat!: deprecate v-t custom directive by @kazupon in https://github.com/intlify/vue-i18n/pull/2045

📝️ Documentations

docx(pluralization.md): Correct spelling from 'gloal' to 'global' by @PuppyOne in https://github.com/intlify/vue-i18n/pull/2038
Fix typo by @shaedrich in https://github.com/intlify/vue-i18n/pull/2040
Fix another typo by @shaedrich in https://github.com/intlify/vue-i18n/pull/2041
docs: add maintenance status by @kazupon in https://github.com/intlify/vue-i18n/pull/2044

New Contributors

@PuppyOne made their first contribution in https://github.com/intlify/vue-i18n/pull/2038
@shaedrich made their first contribution in https://github.com/intlify/vue-i18n/pull/2040

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.0.0-beta.2...v11.0.0-rc.1

Open source →

11.0.0-beta.228 Nov 2024pre-releaseSecurity

fix: security vulnerability fix porting by @kazupon in https://github.com/intlify/vue-i18n/pull/2034

What's Changed

🔒 Security Fixes

fix: security vulnerability fix porting by @kazupon in https://github.com/intlify/vue-i18n/pull/2034

📝️ Documentations

docs: fix wrong plural example by @kazupon in https://github.com/intlify/vue-i18n/pull/2033

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.0.0-beta.1...v11.0.0-beta.2

Open source →

11.0.0-beta.117 Nov 2024pre-release

What's Changed

💥 Breaking Changes

breaking: drop $tc and tc by @kazupon in https://github.com/intlify/vue-i18n/pull/2017

Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.0.0-beta.0...v11.0.0-beta.1

Open source →

11.0.0-beta.014 Nov 2024pre-releaseDeprecated

feat!: deprecate Legacy API mode by @kazupon in https://github.com/intlify/vue-i18n/pull/2016

What's Changed

💥 Breaking Changes

feat!: deprecate Legacy API mode by @kazupon in https://github.com/intlify/vue-i18n/pull/2016

⚡ Improvement Features

fix: tm function should accept DefineLocaleMessage key type by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/2014

📝️ Documentations

Change config prop for quasar flags by @chrissyast in https://github.com/intlify/vue-i18n/pull/2003
docs: Pluralization Page by @Sammuel09 in https://github.com/intlify/vue-i18n/pull/1998
docs: fix composition section by @Sammuel09 in https://github.com/intlify/vue-i18n/pull/2008
fix(docs): correct output in composition api example by @pejeio in https://github.com/intlify/vue-i18n/pull/2012
docs: not use deprecated api by @kazupon in https://github.com/intlify/vue-i18n/pull/2013

New Contributors

@chrissyast made their first contribution in https://github.com/intlify/vue-i18n/pull/2003
@Sammuel09 made their first contribution in https://github.com/intlify/vue-i18n/pull/1998
@pejeio made their first contribution in https://github.com/intlify/vue-i18n/pull/2012

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.4...v11.0.0-beta.0

Open source →

10.0.816 Jul 2025

What's Changed

🔒 Security Fixes

fix: DOM-based XSS via tag attributes for escape parameter by @kazupon in https://github.com/intlify/vue-i18n/pull/2229

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.7...v10.0.8

Open source →

10.0.75 Apr 2025

What's Changed

🐛 Bug Fixes

fix: cannot resolve the ast messages which has json path for v10 by @kazupon in https://github.com/intlify/vue-i18n/pull/2160

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.6...v10.0.7

Open source →

10.0.67 Mar 2025

What's Changed

🔒 Security Fixes

fix: prototype pollution in handleFlatJson, about details see https://github.com/intlify/vue-i18n/security/advisories/GHSA-p2ph-7g93-hw3m

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.5...v10.0.6

Open source →

10.0.528 Nov 2024Security

fix: XSS vulnerability with prototype pollution on AST: https://github.com/intlify/vue-i18n/security/advisories/GHSA-9r9m-ffp6-9x4v

What's Changed

🔒 Security Fixes

fix: XSS vulnerability with prototype pollution on AST: https://github.com/intlify/vue-i18n/security/advisories/GHSA-9r9m-ffp6-9x4v
fix: prototype pollusion on deepCopy: https://github.com/intlify/vue-i18n/security/advisories/GHSA-hjwq-mjwj-4x6c

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.4...v10.0.5

Open source →

10.0.46 Oct 2024

What's Changed

🐛 Bug Fixes

fix: cannot resolve empty string on plural by @kazupon in https://github.com/intlify/vue-i18n/pull/1985

📝️ Documentations

Add petite-vue-i18n package to README by @vikingair in https://github.com/intlify/vue-i18n/pull/1971

New Contributors

@vikingair made their first contribution in https://github.com/intlify/vue-i18n/pull/1971

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.3...v10.0.4

Open source →

10.0.322 Sept 2024

What's Changed

🐛 Bug Fixes

fix(petite-vue-i18n): cannot register correctly message resolver and locale fallbacker by @kazupon in https://github.com/intlify/vue-i18n/pull/1967

📝️ Documentations

docs: add unplugin-vue-i18n setting for petite-vue-i18n by @kazupon in https://github.com/intlify/vue-i18n/pull/1968

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.2...v10.0.3

Open source →

10.0.221 Sept 2024

What's Changed

⚡ Improvement Features

fix: revert #1379 by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/1953
fix: messages deepCopy mutates src arguments by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/1947

📝️ Documentations

docs: add team members by @kazupon in https://github.com/intlify/vue-i18n/pull/1951
docs: add how to use shared locale messages on composition api by @kazupon in https://github.com/intlify/vue-i18n/pull/1964

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.1...v10.0.2

Open source →

10.0.112 Sept 2024

What's Changed

🐛 Bug Fixes

fix: petite-vue-i18n type errors by @TPORL in https://github.com/intlify/vue-i18n/pull/1945

New Contributors

@TPORL made their first contribution in https://github.com/intlify/vue-i18n/pull/1945

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.0...v10.0.1

Open source →

10.0.010 Sept 2024Breaking

fix: typo in migration breaking changes v10 by @khylias in https://github.com/intlify/vue-i18n-next/pull/1854

We are excited to announce the release of Vue I18n v10. We had many contributors.

Thanks for your contributing ❤️

Summary

`petite-vue-i18n` General Availability

petite-vue-i18n is an alternative distribution of Vue I18n, providing only minimal features.

If you don't need the full functionality of vue-i18n and are just looking for basic translation features with a smaller footprint, this will suit your use case.

For more details, please see the docs.

JIT Compilation Enabled by Default

JIT compilation was introduced in v9.3, but it was not enabled by default.

However, it had the following issues:

CSP restrictions: Difficult to work with service/web workers, edge-side runtimes of CDNs, etc.
Backend integration: Hard to fetch messages from a backend (e.g., a database via API) and localize them dynamically.

Starting from v10, JIT compilation is enabled by default.

Support for Generated Locale Types

We provide an interface to extend the Locale type in TypeScript, similar to ComponentCustomProperties in Vue.

This feature is useful when using vue-i18n as part of a framework.

For more details, see the PR for the Nuxt I18n use case.

Changes to `$t` and `t` Overload Signatures for Legacy API Mode

In Vue I18n v9, $t and t had different overload signatures in Composition API mode compared to Legacy API mode.

When migrating from Legacy API mode to Composition API mode, these differences sometimes caused confusion.

Starting from v10, Legacy API mode will use the same $t and t overload signatures as Composition API mode.

For details on the signature pattern, see the migration guide.

Deprecation of `tc` and `$tc` for Legacy API Mode

The t and $t functions already support pluralization, so tc and $tc can be replaced.

In v10, tc and $tc still exist to aid in migration, but they will be fully removed in v11.

If you use them, Vue I18n will display a console warning in your application.

For migration instructions, see the docs.

Dropping Deprecated Features from v9

Some features were marked as deprecated in v9 with warnings.

These deprecated features will be completely removed in v10.

For more details on the deprecated features, see the docs.

🌟 Features

feat: move to GA from experimental for petite-vue-i18n by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1862
feat!: default enable for JIT compilation by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1852
feat: support generated locale type by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/1890
feat!: change $t overloaded signature for Legacy API mode by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1832

❗ Braeking Changes

breaking: drop translation component <i18n> v8.x compatibility by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1844
breaking: drop te behavior v8.x compatibility on v9 by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1845
feat!: deprecate tc and $tc for Legacy API mode by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1839
breaking: drop fully formatter option codes on Legacy API by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1826
breaking: drop fully preserveDirectiveContent option codes on Legacy API by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1827
breaking: drop fully preserve modifier codes on v-t directive by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1828
breaking: drop fully getChoiceIndex on Legacy API by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1829
breaking: drop vue-i18n-bridge by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1816
breaking: drop allowComposition option by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1817
breaking: drop modulo syntax by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1814

⚡ Improvement Features

perf: more bundle size optimization by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1851
fix: type errors by @kazupon in https://github.com/intlify/vue-i18n/pull/1935
fix(devtools): change vue-devtools label by @kazupon in https://github.com/intlify/vue-i18n/pull/1885
fix: vue-i18n type definition for vue package by @kazupon in https://github.com/intlify/vue-i18n/pull/1888
fix: translation interface typing by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1837
fix: reduce devtools pkgs and size by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1823

✏️ Documentation & Sample Updates

Improved the global and local Scope descriptions by @pankajrlal in https://github.com/intlify/vue-i18n/pull/1925
Update ja-JP.json by @awsssrD in https://github.com/intlify/vue-i18n/pull/1914
Update en-US.json by @awsssrD in https://github.com/intlify/vue-i18n/pull/1913
chore: fix module augmentation example comment by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/1898
Added a comment about pluralRules to the code in pluralization docs by @M1h4n1k in https://github.com/intlify/vue-i18n/pull/1873
docs: fix typos by @SimonVadier in https://github.com/intlify/vue-i18n/pull/1863
docs: add scoping for custom directive by @kazupon in https://github.com/intlify/vue-i18n/pull/1867
Update tools.md by @felixhaeberle in https://github.com/intlify/vue-i18n/pull/1866
Fix typos, syntax by @TheoKondak in https://github.com/intlify/vue-i18n/pull/1881
fix: typo in migration breaking changes v10 by @khylias in https://github.com/intlify/vue-i18n-next/pull/1854
docs: fix typo on vue i18n name by @r-moret in https://github.com/intlify/vue-i18n-next/pull/1848
docs: add favicon by @BobbieGoede in https://github.com/intlify/vue-i18n-next/pull/1824
docs: fix typos by @BobbieGoede in https://github.com/intlify/vue-i18n-next/pull/1825
Update started.md to fix typo by @steveclarke in https://github.com/intlify/vue-i18n-next/pull/1822

🐛 Bug Fixes

fix: fallback linked message params by @kazupon in https://github.com/intlify/vue-i18n/pull/1926
fix(types): $t types by @mitjans in https://github.com/intlify/vue-i18n/pull/1883
fix: cannot reduce message-compiler bundle size for runtime by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1860
fix: allow empty default message by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1849
fix: remove unnecessary types from petite-vue-i18n by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1833
fix: Not load devtools on Node.js by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1843
fix(types): allow spyOn of "useI18n()" by @pinguet62 in https://github.com/intlify/vue-i18n-next/pull/1815

New Contributors

@pinguet62 made their first contribution in https://github.com/intlify/vue-i18n/pull/1815
@steveclarke made their first contribution in https://github.com/intlify/vue-i18n/pull/1822
@r-moret made their first contribution in https://github.com/intlify/vue-i18n/pull/1848
@khylias made their first contribution in https://github.com/intlify/vue-i18n/pull/1854
@SimonVadier made their first contribution in https://github.com/intlify/vue-i18n/pull/1863
@felixhaeberle made their first contribution in https://github.com/intlify/vue-i18n/pull/1866
@mitjans made their first contribution in https://github.com/intlify/vue-i18n/pull/1883
@TheoKondak made their first contribution in https://github.com/intlify/vue-i18n/pull/1881
@M1h4n1k made their first contribution in https://github.com/intlify/vue-i18n/pull/1873
@awsssrD made their first contribution in https://github.com/intlify/vue-i18n/pull/1914
@pankajrlal made their first contribution in https://github.com/intlify/vue-i18n/pull/1925

Full Changelog: https://github.com/intlify/vue-i18n/compare/v9.13.1...v10.0.0

Open source →

10.0.0-rc.15 Sept 2024pre-release

What's Changed

⚡ Improvement Features

fix: type errors by @kazupon in https://github.com/intlify/vue-i18n/pull/1935

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.0-beta.6...v10.0.0-rc.1

Open source →

10.0.0-beta.629 Aug 2024pre-release

What's Changed

🐛 Bug Fixes

fix: fallback linked message params by @kazupon in https://github.com/intlify/vue-i18n/pull/1926

📝️ Documentations

Improved the global and local Scope descriptions by @pankajrlal in https://github.com/intlify/vue-i18n/pull/1925

🍭 Examples

Update ja-JP.json by @awsssrD in https://github.com/intlify/vue-i18n/pull/1914
Update en-US.json by @awsssrD in https://github.com/intlify/vue-i18n/pull/1913

New Contributors

@awsssrD made their first contribution in https://github.com/intlify/vue-i18n/pull/1914
@pankajrlal made their first contribution in https://github.com/intlify/vue-i18n/pull/1925

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.0-beta.5...v10.0.0-beta.6

Open source →

10.0.0-beta.519 Jul 2024pre-release

What's Changed

📝️ Documentations

chore: fix module augmentation example comment by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/1898

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.0-beta.4...v10.0.0-beta.5

Open source →

10.0.0-beta.416 Jul 2024pre-release

What's Changed

🌟 Features

feat: support generated locale type by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/1890

📝️ Documentations

Added a comment about pluralRules to the code in pluralization docs by @M1h4n1k in https://github.com/intlify/vue-i18n/pull/1873

New Contributors

@M1h4n1k made their first contribution in https://github.com/intlify/vue-i18n/pull/1873

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.0-beta.3...v10.0.0-beta.4

Open source →

10.0.0-beta.314 Jul 2024pre-release

What's Changed

⚡ Improvement Features

fix(devtools): change vue-devtools label by @kazupon in https://github.com/intlify/vue-i18n/pull/1885
fix: vue-i18n type definition for vue package by @kazupon in https://github.com/intlify/vue-i18n/pull/1888

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.0-beta.2...v10.0.0-beta.3

Open source →

10.0.0-beta.25 Jul 2024pre-release

What's Changed

🐛 Bug Fixes

fix(types): $t types by @mitjans in https://github.com/intlify/vue-i18n/pull/1883

📝️ Documentations

docs: fix typos by @SimonVadier in https://github.com/intlify/vue-i18n/pull/1863
docs: add scoping for custom directive by @kazupon in https://github.com/intlify/vue-i18n/pull/1867
Update tools.md by @felixhaeberle in https://github.com/intlify/vue-i18n/pull/1866
Fix typos, syntax by @TheoKondak in https://github.com/intlify/vue-i18n/pull/1881

New Contributors

@SimonVadier made their first contribution in https://github.com/intlify/vue-i18n/pull/1863
@felixhaeberle made their first contribution in https://github.com/intlify/vue-i18n/pull/1866
@mitjans made their first contribution in https://github.com/intlify/vue-i18n/pull/1883
@TheoKondak made their first contribution in https://github.com/intlify/vue-i18n/pull/1881

Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.0-beta.1...v10.0.0-beta.2

Open source →

10.0.0-beta.123 May 2024pre-releaseBreaking

fix: typo in migration breaking changes v10 by @khylias in https://github.com/intlify/vue-i18n-next/pull/1854

What's Changed

🌟 Features

feat: move to GA from experimental for petite-vue-i18n by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1862

🐛 Bug Fixes

fix: cannot reduce message-compiler bundle size for runtime by @kazupon in https://github.com/intlify/vue-i18n-next/pull/1860

📝️ Documentations

fix: typo in migration breaking changes v10 by @khylias in https://github.com/intlify/vue-i18n-next/pull/1854

New Contributors

@khylias made their first contribution in https://github.com/intlify/vue-i18n-next/pull/1854

Full Changelog: https://github.com/intlify/vue-i18n-next/compare/v10.0.0-alpha.5...v10.0.0-beta.1

Open source →

Your coding agent can read these notes before it upgrades. Set up the MCP server →