You are browsing Nuxt 2 docs. Go to Nuxt 3 docs， or learn more about Nuxt 2 Long Term Support.

Translated page Contents of this page might be outdated.
Read the original page Improve translation of this page

The globalName property

Nuxt lets you customize the global ID used in the main HTML template as well as the main Vue instance name and other options.

  • Type: String
  • Default: nuxt
nuxt.config.js
{
  globalName: 'myCustomName'
}
The globalName needs to be a valid JavaScript identifier, and changing it may break support for certain plugins that rely on Nuxt-named functions. If you're looking to just change the visible __nuxt HTML ID, then use the globals property.

The globals property

Customizes specific global names which are based on globalName by default.

  • Type: Object
  • Default:
nuxt.config.js
globals: {
  id: globalName => `__${globalName}`,
  nuxt: globalName => `$${globalName}`,
  context: globalName => `__${globalName.toUpperCase()}__`,
  pluginPrefix: globalName => globalName,
  readyCallback: globalName => `on${_.capitalize(globalName)}Ready`,
  loadedCallback: globalName => `_on${_.capitalize(globalName)}Loaded`
},
Edit this page on GitHub Updated at Tue, Apr 14, 2026