NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #4793 most downloaded on npm
@intlify/shared
Latest stable
11.4.18
Last release 19 days ago
03 Nov 2026
Ships fairly regularly
a new release about every 2 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
226 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.9 -->
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.9 -->
escapeParameter: The sanitizer now also turns <script> in translations into text. A <script> does not run with v-html in the browser, but it runs when the translation is rendered on the server (SSR). (a66ace0a) See GHSA-jrxq-gc2q-9357.
Full Changelog: https://github.com/intlify/vue-i18n/compare/v12.0.0-alpha.8...v12.0.0-alpha.9
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.8 -->
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.8 -->
install is synchronous: app.use(i18n) now throws the errors in install, which were unhandled rejections, and i18n.install() returns undefined instead of a Promise that never settled in development without the devtools. (#2740)
escapeParameter: The sanitizer now also disables javascript: URLs in xlink:href, and turns <base>, <animate> and <set> in translations into text. SVG animations with <animate> or <set> in HTML messages no longer run while escapeParameter is enabled. (b27a50e4) See GHSA-473g-cvf6-mfxj.
Full Changelog: https://github.com/intlify/vue-i18n/compare/v12.0.0-alpha.7...v12.0.0-alpha.8
Your coding agent can read these notes before it upgrades. Set up the MCP server →
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.7 -->
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.7 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v12.0.0-alpha.6...v12.0.0-alpha.7
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.6 -->
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.6 -->
@intlify/devtools-types dependencies by @kazupon in https://github.com/intlify/vue-i18n/pull/2714isKeylessObject() assignable to its parameter by @kazupon in https://github.com/intlify/vue-i18n/pull/2715createCoreContext() by @kazupon in https://github.com/intlify/vue-i18n/pull/2716d() and n() in the i18n-d and i18n-n components by @kazupon in https://github.com/intlify/vue-i18n/pull/2726useI18n() and mangle() by @kazupon in https://github.com/intlify/vue-i18n/pull/2728Full Changelog: https://github.com/intlify/vue-i18n/compare/v12.0.0-alpha.5...v12.0.0-alpha.6
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.5 -->
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.5 -->
part option when format key is omitted in number/datetime by @babu-ch in https://github.com/intlify/vue-i18n/pull/2520Full Changelog: https://github.com/intlify/vue-i18n/compare/v12.0.0-alpha.4...v12.0.0-alpha.5
fix: backport CVE-2025-53892 (escapeParameterHtml DOM XSS hardening) to master by @vulgraph in https://github.com/intlify/vue-i18n/pull/2470
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.4 -->
Intl.PluralRules by @kazupon in https://github.com/intlify/vue-i18n/pull/2400n/$n and d/$d formatting by @kazupon in https://github.com/intlify/vue-i18n/pull/2418$n overloads use DefineNumberFormat instead of DefineDateTimeFormat by @babu-ch in https://github.com/intlify/vue-i18n/pull/2459register* global functions in favor of createI18n options by @kazupon in https://github.com/intlify/vue-i18n/pull/2445n and $n typings by @kazupon in https://github.com/intlify/vue-i18n/pull/2174vitest/node types to fix Vitest 4 type errors by @haoqunjiang in https://github.com/intlify/vue-i18n/pull/2303useI18n implementation with provide-inject fully by @kazupon in https://github.com/intlify/vue-i18n/pull/2357n() and $n() with undefined should not throw errors by @kazupon in https://github.com/intlify/vue-i18n/pull/2417shallowRef server-side for datetimeFormats by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/2333rt link by @Nikita0x in https://github.com/intlify/vue-i18n/pull/2393availableLocales by @kazupon in https://github.com/intlify/vue-i18n/pull/2420Full Changelog: https://github.com/intlify/vue-i18n/compare/v12.0.0-alpha.2...v12.0.0-alpha.4
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.3 -->
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.3 -->
n and $n typings by @kazupon in https://github.com/intlify/vue-i18n/pull/2174Full Changelog: https://github.com/intlify/vue-i18n/compare/v12.0.0-alpha.2...v12.0.0-alpha.3
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.2 -->
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.2 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v12.0.0-alpha.1...v12.0.0-alpha.2
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.1 -->
<!-- Release notes generated using configuration in .github/release.yml at v12.0.0-alpha.1 -->
availableLocales using computed property by @mnenie in https://github.com/intlify/vue-i18n/pull/2058ComponentCustomProperties['$i18n'] type by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/2093mangle option name from minify option name by @kazupon in https://github.com/intlify/vue-i18n/pull/2064v-t limitations and reactivity behavior by @docnoe in https://github.com/intlify/vue-i18n/pull/2118Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.0.1...v12.0.0-alpha.1
<!-- Release notes generated using configuration in .github/release.yml at v11.4.18 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.18 -->
escapeParameter: The sanitizer now also turns <script> in translations into text. A <script> does not run with v-html in the browser, but it runs when the translation is rendered on the server (SSR). (#2757) See GHSA-jrxq-gc2q-9357.
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.17...v11.4.18
<!-- Release notes generated using configuration in .github/release.yml at v11.4.17 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.17 -->
install is synchronous: app.use(i18n) now throws the errors in install. They were unhandled rejections, which left the app half-installed (and ended Node.js processes without a handler for them), so if app.use(i18n) throws after you update, the install was failing before, too. i18n.install() returns undefined instead of a Promise that never settled in development without the devtools. (#2741)
Legacy API: A regular expression in silentTranslationWarn or silentFallbackWarn now suppresses the warnings for the keys that match it. As an option of createI18n, it suppressed all the warnings, and set to the property, it suppressed the warnings for the keys that did not match it. (#2744)
escapeParameter: The sanitizer now also disables javascript: URLs in xlink:href, and turns <base>, <animate> and <set> in translations into text. SVG animations with <animate> or <set> in HTML messages no longer run while escapeParameter (escapeParameterHtml in the Legacy API) is enabled. (#2756) See GHSA-473g-cvf6-mfxj.
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.16...v11.4.17
<!-- Release notes generated using configuration in .github/release.yml at v11.4.16 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.16 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.15...v11.4.16
<!-- Release notes generated using configuration in .github/release.yml at v11.4.15 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.15 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.14...v11.4.15
<!-- Release notes generated using configuration in .github/release.yml at v11.4.14 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.14 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.13...v11.4.14
<!-- Release notes generated using configuration in .github/release.yml at v11.4.13 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.13 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.12...v11.4.13
<!-- Release notes generated using configuration in .github/release.yml at v11.4.12 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.12 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.10...v11.4.12
<!-- Release notes generated using configuration in .github/release.yml at v11.4.10 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.10 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.9...v11.4.10
<!-- Release notes generated using configuration in .github/release.yml at v11.4.9 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.9 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.8...v11.4.9
<!-- Release notes generated using configuration in .github/release.yml at v11.4.8 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.8 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.7...v11.4.8
<!-- Release notes generated using configuration in .github/release.yml at v11.4.7 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.7 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.6...v11.4.7
<!-- Release notes generated using configuration in .github/release.yml at v11.4.6 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.6 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.5...v11.4.6
<!-- Release notes generated using configuration in .github/release.yml at v11.4.5 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.5 -->
part option when format key is omitted in number/datetime by @kazupon in https://github.com/intlify/vue-i18n/pull/2522Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.4...v11.4.5
<!-- Release notes generated using configuration in .github/release.yml at v11.4.4 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.4 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.3...v11.4.4
<!-- Release notes generated using configuration in .github/release.yml at v11.4.3 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.3 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.2...v11.4.3
<!-- Release notes generated using configuration in .github/release.yml at v11.4.2 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.2 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.1...v11.4.2
<!-- Release notes generated using configuration in .github/release.yml at v11.4.1 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.1 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.4.0...v11.4.1
<!-- Release notes generated using configuration in .github/release.yml at v11.4.0 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.4.0 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.3.2...v11.4.0
<!-- Release notes generated using configuration in .github/release.yml at v11.3.2 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.3.2 -->
register* functions tree-shaking for intlify/core by @kazupon in https://github.com/intlify/vue-i18n/pull/2464Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.3.1...v11.3.2
<!-- Release notes generated using configuration in .github/release.yml at v11.3.1 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.3.1 -->
$n overloads use DefineNumberFormat instead of DefineDateTimeFormat by @kazupon in https://github.com/intlify/vue-i18n/pull/2461Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.3.0...v11.3.1
<!-- Release notes generated using configuration in .github/release.yml at v11.3.0 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.3.0 -->
@intlify/devtools-types dependencies by @kazupon in https://github.com/intlify/vue-i18n/pull/2411n() and $n() with undefined should not throw errors by @kazupon in https://github.com/intlify/vue-i18n/pull/2429! breaks n/$n and d/$d formatting by @kazupon in https://github.com/intlify/vue-i18n/pull/2434shallowRef server-side for datetimeFormats by @kazupon in https://github.com/intlify/vue-i18n/pull/2428Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.2.8...v11.3.0
<!-- Release notes generated using configuration in .github/release.yml at v11.2.8 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.2.8 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.2.7...v11.2.8
<!-- Release notes generated using configuration in .github/release.yml at v11.2.7 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.2.7 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.2.6...v11.2.7
<!-- Release notes generated using configuration in .github/release.yml at v11.2.6 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.2.6 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.2.5...v11.2.6
<!-- Release notes generated using configuration in .github/release.yml at v11.2.2 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.2.2 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.2.1...v11.2.2
<!-- Release notes generated using configuration in .github/release.yml at v11.2.1 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.2.1 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.2.0...v11.2.1
<!-- Release notes generated using configuration in .github/release.yml at v11.1.12 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.1.12 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.11...v11.1.12
<!-- Release notes generated using configuration in .github/release.yml at v11.1.11 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.1.11 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.10...v11.1.11
<!-- Release notes generated using configuration in .github/release.yml at v11.1.10 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.1.10 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.9...v11.1.10
<!-- Release notes generated using configuration in .github/release.yml at v11.1.9 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.1.9 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.8...v11.1.9
<!-- Release notes generated using configuration in .github/release.yml at v11.1.8 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.1.8 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.7...v11.1.8
<!-- Release notes generated using configuration in .github/release.yml at v11.1.7 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.1.7 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.6...v11.1.7
<!-- Release notes generated using configuration in .github/release.yml at v11.1.6 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.1.6 -->
useI18n calling on local scope by @kazupon in https://github.com/intlify/vue-i18n/pull/2203Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.5...v11.1.6
<!-- Release notes generated using configuration in .github/release.yml at v11.1.5 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.1.5 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.4...v11.1.5
<!-- Release notes generated using configuration in .github/release.yml at v11.1.4 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.1.4 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.3...v11.1.4
<!-- Release notes generated using configuration in .github/release.yml at v11.1.3 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.1.3 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.2...v11.1.3
<!-- Release notes generated using configuration in .github/release.yml at v11.1.2 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.1.2 -->
handleFlatJson, about details see https://github.com/intlify/vue-i18n/security/advisories/GHSA-p2ph-7g93-hw3mFull Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.1...v11.1.2
<!-- Release notes generated using configuration in .github/release.yml at v11.1.1 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.1.1 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.1.0...v11.1.1
<!-- Release notes generated using configuration in .github/release.yml at v11.1.0 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.1.0 -->
ComponentCustomProperties['$i18n'] type by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/2094Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.0.1...v11.1.0
<!-- Release notes generated using configuration in .github/release.yml at v11.0.1 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.0.1 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.0.0...v11.0.1
fix: security vulnerability fix porting by @kazupon in https://github.com/intlify/vue-i18n/pull/2034
<!-- Release notes generated using configuration in .github/release.yml at v11.0.0 -->
We are excited to announce the release of Vue I18n v11. We had many contributors.
Thanks for your contributing ❤️
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
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.
v-tThe 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.
tc and $tc for Legacy API modeThese APIs had already deprecated in warning about being dropped in v11. docs says
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:
<img src="https://raw.githubusercontent.com/intlify/vue-i18n/master/docs/public/lifecycle2025.svg" />
You can check the maintenance status on the docs
$tc and tc by @kazupon in https://github.com/intlify/vue-i18n/pull/2017v-t custom directive by @kazupon in https://github.com/intlify/vue-i18n/pull/2045tm function should accept DefineLocaleMessage key type by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/2014Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.4...v11.0.0
feat!: deprecate v-t custom directive by @kazupon in https://github.com/intlify/vue-i18n/pull/2045
<!-- Release notes generated using configuration in .github/release.yml at v11.0.0-rc.1 -->
v-t custom directive by @kazupon in https://github.com/intlify/vue-i18n/pull/2045Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.0.0-beta.2...v11.0.0-rc.1
fix: security vulnerability fix porting by @kazupon in https://github.com/intlify/vue-i18n/pull/2034
<!-- Release notes generated using configuration in .github/release.yml at v11.0.0-beta.2 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.0.0-beta.1...v11.0.0-beta.2
<!-- Release notes generated using configuration in .github/release.yml at v11.0.0-beta.1 -->
<!-- Release notes generated using configuration in .github/release.yml at v11.0.0-beta.1 -->
$tc and tc by @kazupon in https://github.com/intlify/vue-i18n/pull/2017Full Changelog: https://github.com/intlify/vue-i18n/compare/v11.0.0-beta.0...v11.0.0-beta.1
feat!: deprecate Legacy API mode by @kazupon in https://github.com/intlify/vue-i18n/pull/2016
<!-- Release notes generated using configuration in .github/release.yml at v11.0.0-beta.0 -->
tm function should accept DefineLocaleMessage key type by @BobbieGoede in https://github.com/intlify/vue-i18n/pull/2014Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.4...v11.0.0-beta.0
<!-- Release notes generated using configuration in .github/release.yml at v10.0.8 -->
<!-- Release notes generated using configuration in .github/release.yml at v10.0.8 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.7...v10.0.8
<!-- Release notes generated using configuration in .github/release.yml at v10.0.7 -->
<!-- Release notes generated using configuration in .github/release.yml at v10.0.7 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.6...v10.0.7
<!-- Release notes generated using configuration in .github/release.yml at v10.0.6 -->
<!-- Release notes generated using configuration in .github/release.yml at v10.0.6 -->
handleFlatJson, about details see https://github.com/intlify/vue-i18n/security/advisories/GHSA-p2ph-7g93-hw3mFull Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.5...v10.0.6
fix: XSS vulnerability with prototype pollution on AST: https://github.com/intlify/vue-i18n/security/advisories/GHSA-9r9m-ffp6-9x4v
<!-- Release notes generated using configuration in .github/release.yml at v10.0.5 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.4...v10.0.5
<!-- Release notes generated using configuration in .github/release.yml at v10.0.4 -->
<!-- Release notes generated using configuration in .github/release.yml at v10.0.4 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.3...v10.0.4
<!-- Release notes generated using configuration in .github/release.yml at v10.0.3 -->
<!-- Release notes generated using configuration in .github/release.yml at v10.0.3 -->
Full Changelog: https://github.com/intlify/vue-i18n/compare/v10.0.2...v10.0.3
One column per quarter.