Compatibility Note

  • Vue.js 2.0.0+

Direct Download / CDN provides NPM-based CDN links. The above link will always point to the latest release on NPM. You can also use a specific version/tag via URLs like

Include vue-i18n after Vue and it will install itself automatically:

<script src=""></script>
<script src=""></script>


npm install vue-i18n


yarn add vue-i18n

When using with a module system, you must explicitly install the vue-i18n via Vue.use():

import Vue from 'vue'
import VueI18n from 'vue-i18n'


You don't need to do this when using global script tags.

Vue Cli 3.x

vue add i18n

You need Vue cli 3.x as pre-requisite, you can install it on your shell with the next command:

npm install @vue/cli -g

Dev Build

You will have to clone directly from GitHub and build vue-i18n yourself if you want to use the latest dev build.

git clone node_modules/vue-i18n
cd node_modules/vue-i18n
npm install # or `yarn`
npm run build  # or `yarn run build`

Explanation of Different Builds

In the dist/ directory of the NPM package you will find many different builds of VueI18n. Here’s an overview of the difference between them:

  • UMD: vue-i18n.js
  • CommonJS: vue-i18n.common.js
  • ES Module for bundlers: vue-i18n.esm.js
  • ES Module for browsers: vue-i18n.esm.browser.js


  • UMD: UMD builds can be used directly in the browser via a <script> tag. The default file from Unpkg CDN at is the UMD build (vue-i18n.js).

  • CommonJS: CommonJS builds are intended for use with older bundlers like browserify or webpack 1. The default file for these bundlers (pkg.main) is the Runtime only CommonJS build (vue-i18n.common.js).

  • ES Module: starting in 8.11 VueI18n provides two ES Modules (ESM) builds:

    • ESM for bundlers: intended for use with modern bundlers like webpack 2 or Rollup. ESM format is designed to be statically analyzable so the bundlers can take advantage of that to perform "tree-shaking" and eliminate unused code from your final bundle. The default file for these bundlers (pkg.module) is the Runtime only ES Module build (vue-i18n.esm.js).
    • ESM for browsers (8.11+ only, vue-i18n.esm.browser.js): intended for direct imports in modern browsers via <script type="module">.
Last Updated: 12/18/2019, 12:11:01 PM