---
title: "Installation · Nuxt Scripts"
description: "Install Nuxt Scripts in an existing Nuxt project."
canonical_url: "https://scripts.nuxt.com/docs/getting-started/installation"
meta:
  "og:description": "Install Nuxt Scripts in an existing Nuxt project."
  "og:image": "https://scripts.nuxt.com/_og/s/o_52eb0813e022ff47.png"
  "og:image:height": "600"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "Installation · Nuxt Scripts"
  "twitter:image": "https://scripts.nuxt.com/_og/s/o_52eb0813e022ff47.png"
---

> Index of every page on this site: [llms.txt](https://scripts.nuxt.com/llms.txt)

**Getting Started**

# **Installation**

[Copy for LLMs](https://scripts.nuxt.com/docs/getting-started/installation.md)

## 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:

```bash
npx nuxi@latest upgrade --force
```

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

```bash
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**](https://skilld.dev/gh/nuxt/scripts/nuxt-scripts)*.*

The [**Nuxt module command**](https://nuxt.com/docs/api/commands/module) 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:

```bash
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**](https://scripts.nuxt.com/docs/getting-started/confetti-tutorial).
2. Learn when scripts load in [**Script Triggers**](https://scripts.nuxt.com/docs/guides/script-triggers).
3. Check the [**Script Registry**](https://scripts.nuxt.com/scripts) for a preconfigured integration.
4. Load an unlisted script with [`**useScript()**`](https://scripts.nuxt.com/docs/api/use-script) or [**Global Scripts**](https://scripts.nuxt.com/docs/guides/global).
5. Configure [**First-Party Mode**](https://scripts.nuxt.com/docs/guides/first-party) or [**Consent Management**](https://scripts.nuxt.com/docs/guides/consent).
6. Review every module option in the [**Nuxt Config reference**](https://scripts.nuxt.com/docs/api/nuxt-config).

[Edit this page](https://github.com/nuxt/scripts/edit/main/docs/content/1.getting-started/2.installation.md)

[Markdown For LLMs](https://scripts.nuxt.com/docs/getting-started/installation.md)

[**Introduction** Load third-party scripts in Nuxt with typed APIs, loading controls, and privacy defaults.](https://scripts.nuxt.com/docs/getting-started) [**Tutorial: Load js-confetti** Learn how to load the js-confetti script using the Nuxt Scripts module.](https://scripts.nuxt.com/docs/getting-started/confetti-tutorial)

**On this page **

- [Quick Start](#quick-start)
- [Next Steps](#next-steps)

```json
{"@context":"https://schema.org","@graph":[{"@id":"https://scripts.nuxt.com/#website","@type":"WebSite","description":"Nuxt Scripts lets you load third-party scripts with better performance, privacy, security and DX. It includes many popular third-parties out of the box.","name":"Nuxt Scripts","url":"https://scripts.nuxt.com/","publisher":{"@id":"https://scripts.nuxt.com/#identity"}},{"@id":"https://scripts.nuxt.com/docs/getting-started/installation#webpage","@type":"WebPage","description":"Install Nuxt Scripts in an existing Nuxt project.","name":"Installation","url":"https://scripts.nuxt.com/docs/getting-started/installation","breadcrumb":{"@id":"https://scripts.nuxt.com/docs/getting-started/installation#breadcrumb"},"isPartOf":{"@id":"https://scripts.nuxt.com/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://scripts.nuxt.com/docs/getting-started/installation"]}],"primaryImageOfPage":{"@id":"https://scripts.nuxt.com/#logo"}},{"@id":"https://scripts.nuxt.com/#identity","@type":"Organization","name":"Nuxt Scripts","url":"https://scripts.nuxt.com","logo":{"@id":"https://scripts.nuxt.com/#logo"}},{"@id":"https://scripts.nuxt.com/docs/getting-started/installation#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Nuxt Scripts","item":"https://scripts.nuxt.com/","position":1},{"@type":"ListItem","name":"Documentation","item":"https://scripts.nuxt.com/docs","position":2},{"@type":"ListItem","name":"Getting Started","item":"https://scripts.nuxt.com/docs/getting-started","position":3},{"@type":"ListItem","name":"Installation","item":"https://scripts.nuxt.com/docs/getting-started/installation","position":4}]},{"@id":"https://scripts.nuxt.com/#logo","@type":"ImageObject","caption":"Nuxt Scripts","contentUrl":"https://scripts.nuxt.com/logo.svg","inLanguage":"en","url":"https://scripts.nuxt.com/logo.svg"}]}
```

## Sitemap

See the full [sitemap](https://scripts.nuxt.com/sitemap.md) for all pages.
