---
title: "Nuxt Hooks · Nuxt Scripts"
description: "Add registry scripts from a Nuxt module at build time."
canonical_url: "https://scripts.nuxt.com/docs/api/nuxt-hooks"
meta:
  "og:description": "Add registry scripts from a Nuxt module at build time."
  "og:image": "https://scripts.nuxt.com/_og/s/o_f49198640334c291.png"
  "og:image:height": "600"
  "og:image:type": image/png
  "og:image:width": "1200"
  "og:title": "Nuxt Hooks · Nuxt Scripts"
  "twitter:image": "https://scripts.nuxt.com/_og/s/o_f49198640334c291.png"
---

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

**Api**

# **Nuxt Hooks**

[Copy for LLMs](https://scripts.nuxt.com/docs/api/nuxt-hooks.md)

## `**scripts:registry**`

- Type: `**(registry: RegistryScripts) => void | Promise<void>**`

Use this module hook to add registry scripts at build time. Applications can then configure them through `**scripts.registry**` and call their auto-imported composables.

module.ts

```ts
import { createResolver, defineNuxtModule } from '@nuxt/kit'

const { resolve } = createResolver(import.meta.url)

export default defineNuxtModule({
  setup(_options, nuxt) {
    nuxt.hooks.hook('scripts:registry', async (registry) => {
      registry.push({
        // Shown in DevTools
        label: 'My Custom Script',
        logo: `<svg class="w-10 h-10" xmlns="http://www.w3.org/2000/svg" width="28.85" height="32" viewBox="0 0 256 284"><path fill="#F9AB00" d="M256.003 247.933a35.224 35.224 0 0 1-39.376 35.161c-18.044-2.67-31.266-18.371-30.826-36.606V36.845C185.365 18.591 198.62 2.881 216.687.24a35.221 35.221 0 0 1 39.316 35.16z"/><path fill="#E37400" d="M35.101 213.193c19.386 0 35.101 15.716 35.101 35.101c0 19.386-15.715 35.101-35.101 35.101S0 267.68 0 248.295c0-19.386 15.715-35.102 35.101-35.102m92.358-106.387c-19.477 1.068-34.59 17.406-34.137 36.908v94.285c0 25.588 11.259 41.122 27.755 44.433a35.161 35.161 0 0 0 42.146-34.56V142.089a35.222 35.222 0 0 0-35.764-35.282"/></svg>`,
        // Static script URL and bundling capability
        src: 'https://cdn.jsdelivr.net/npm/my-custom-script@1.0.0',
        bundle: true,
        // Auto-imported composable
        import: {
          name: 'useScriptMyCustomScript',
          from: resolve('./runtime/scripts/my-custom-script'),
        },
      })
    })
  },
})
```

[Edit this page](https://github.com/nuxt/scripts/edit/main/docs/content/3.api/6.nuxt-hooks.md)

[Markdown For LLMs](https://scripts.nuxt.com/docs/api/nuxt-hooks.md)

[**Nuxt App Hooks** Inspect scripts in development or change declared globals at runtime.](https://scripts.nuxt.com/docs/api/nuxt-app-hooks) [**v0 to v1** Migration guide for upgrading from Nuxt Scripts v0.x to v1.0.](https://scripts.nuxt.com/docs/migration-guide/v0-to-v1)

```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/api/nuxt-hooks#webpage","@type":"WebPage","description":"Add registry scripts from a Nuxt module at build time.","name":"Nuxt Hooks","url":"https://scripts.nuxt.com/docs/api/nuxt-hooks","breadcrumb":{"@id":"https://scripts.nuxt.com/docs/api/nuxt-hooks#breadcrumb"},"isPartOf":{"@id":"https://scripts.nuxt.com/#website"},"potentialAction":[{"@type":"ReadAction","target":["https://scripts.nuxt.com/docs/api/nuxt-hooks"]}],"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/api/nuxt-hooks#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":"API","item":"https://scripts.nuxt.com/docs/api","position":3},{"@type":"ListItem","name":"Nuxt Hooks","item":"https://scripts.nuxt.com/docs/api/nuxt-hooks","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.
