Installation

Quick Start

Nuxt Scripts 2 requires Nuxt ^4.6.0 || ^5.0.0 and Unhead ^3.4.2. The supported Node.js range is ^22.22.3 || ^24.15.0 || >=26.0.0. Upgrade an existing project before installing:

npx nuxi@latest upgrade --force

Nuxt Scripts 2 is available on the beta channel. Run:

pnpm exec nuxt module add @nuxt/scripts@beta

Using an AI agent? Get the @nuxt/scripts Skill on skilld.dev/gh/nuxt/scripts/nuxt-scripts.

The Nuxt module command installs Nuxt Scripts and adds it to the modules array in your Nuxt config.

The DevTools panel uses the optional @nuxt/scripts-devtools package. Install the same version as @nuxt/scripts, then restart Nuxt:

pnpm add -D @nuxt/scripts-devtools@beta

Next Steps

From here, choose the guide closest to what you need:

1. Build a small integration with the Confetti Tutorial.
2. Learn when scripts load in Script Triggers.
3. Check the Script Registry for a preconfigured integration.
4. Load an unlisted script with useScript() or Global Scripts.
5. Configure First-Party Mode or Consent Management.