Overview · Unhead

[Unhead Home](https://unhead.unjs.io/ "Home")

- [Docs](https://unhead.unjs.io/docs/solid-js/head/guides/get-started/overview)
- [Tools](https://unhead.unjs.io/tools)
- [Learn](https://unhead.unjs.io/learn/guides/what-is-capo)

[Releases](https://unhead.unjs.io/releases)

Search…```k`` /`

[Unhead on GitHub](https://github.com/unjs/unhead)

[User Guides](https://unhead.unjs.io/docs/solid-js/head/guides/get-started/overview)

[API](https://unhead.unjs.io/docs/solid-js/head/api/get-started/overview)

[Releases](https://unhead.unjs.io/docs/solid-js/releases/v3)

Solid.js

- [Switch to Solid.js](https://unhead.unjs.io/docs/solid-js/head/api/get-started/overview)
- [Switch to TypeScript](https://unhead.unjs.io/docs/typescript/head/api/get-started/overview)
- [Switch to Vue](https://unhead.unjs.io/docs/vue/head/api/get-started/overview)
- [Switch to React](https://unhead.unjs.io/docs/react/head/api/get-started/overview)
- [Switch to Svelte](https://unhead.unjs.io/docs/svelte/head/api/get-started/overview)
- [Switch to Angular](https://unhead.unjs.io/docs/angular/head/api/get-started/overview)
- [Switch to Nuxt](https://unhead.unjs.io/docs/nuxt/head/api/get-started/overview)

v3 (stable)

Head

- [Discord Support](https://discord.com/invite/275MBUBvgP)

- Get Started
  - [Overview](https://unhead.unjs.io/docs/solid-js/head/api/get-started/overview)
- Composables
  - [`useHead()`](https://unhead.unjs.io/docs/solid-js/head/api/composables/use-head)
  - [`useHeadSafe()`](https://unhead.unjs.io/docs/solid-js/head/api/composables/use-head-safe)
  - [`useSeoMeta()`](https://unhead.unjs.io/docs/solid-js/head/api/composables/use-seo-meta)
  - [`useScript()`](https://unhead.unjs.io/docs/solid-js/head/api/composables/use-script)
- Hooks
  - [entries:updated](https://unhead.unjs.io/docs/solid-js/head/api/hooks/entries-updated)
  - [entries:resolve](https://unhead.unjs.io/docs/solid-js/head/api/hooks/entries-resolve)
  - [entries:normalize](https://unhead.unjs.io/docs/solid-js/head/api/hooks/entries-normalize)
  - [tag:normalise](https://unhead.unjs.io/docs/solid-js/head/api/hooks/tag-normalise)
  - [tags:beforeResolve](https://unhead.unjs.io/docs/solid-js/head/api/hooks/tags-before-resolve)
  - [tags:resolve](https://unhead.unjs.io/docs/solid-js/head/api/hooks/tags-resolve)
  - [tags:afterResolve](https://unhead.unjs.io/docs/solid-js/head/api/hooks/tags-after-resolve)
  - [dom:beforeRender](https://unhead.unjs.io/docs/solid-js/head/api/hooks/dom-before-render)
  - [ssr:beforeRender](https://unhead.unjs.io/docs/solid-js/head/api/hooks/ssr-before-render)
  - [ssr:render](https://unhead.unjs.io/docs/solid-js/head/api/hooks/ssr-render)
  - [ssr:rendered](https://unhead.unjs.io/docs/solid-js/head/api/hooks/ssr-rendered)
  - [script:updated](https://unhead.unjs.io/docs/solid-js/head/api/hooks/script-updated)
- [Plugins](https://unhead.unjs.io/docs/head/api/plugins)

Get Started

# Overview

Last updated Apr 9, 2026 by [Harlan Wilton](https://github.com/harlan-zw) in [refactor(bundler)!: named Unhead export, ctx-based transforms, dev-mode validate (#733)](https://github.com/unjs/unhead/pull/733).

On this page

- [What composables are available?](#what-composables-are-available)
- [How do I create plugins?](#how-do-i-create-plugins)
- [What hooks can I use?](#what-hooks-can-i-use)

**Quick Reference:** The main composables are `useHead()` for general head management, `useSeoMeta()` for SEO tags, and `useScript()` for script loading. All return an entry with `patch()` and `dispose()` methods.

## [What composables are available?](#what-composables-are-available)

useHead()

The main composable for managing head tags.

[useHead()](https://unhead.unjs.io/docs/head/api/composables/use-head)

useHeadSafe()

XSS-safe head management for user-generated content.

[useHeadSafe()](https://unhead.unjs.io/docs/head/api/composables/use-head-safe)

useSeoMeta()

A composable for managing SEO-related tags.

[useSeoMeta()](https://unhead.unjs.io/docs/head/api/composables/use-seo-meta)

useScript()

A composable for loading and managing external scripts.

[useScript()](https://unhead.unjs.io/docs/head/api/composables/use-script)

## [How do I create plugins?](#how-do-i-create-plugins)

See the [Plugins API](https://unhead.unjs.io/docs/head/api/plugins) for creating custom plugins with `defineHeadPlugin`.

## [What hooks can I use?](#what-hooks-can-i-use)

### [Entry Hooks](#entry-hooks)

- [entries:updated](https://unhead.unjs.io/docs/head/api/hooks/entries-updated) - Called when entries have been updated
- [entries:resolve](https://unhead.unjs.io/docs/head/api/hooks/entries-resolve) - Called when entries need to be resolved to tags
- [entries:normalize](https://unhead.unjs.io/docs/head/api/hooks/entries-normalize) - Called when an entry is being normalized to tags

### [How do I hook into tag resolution?](#how-do-i-hook-into-tag-resolution)

- [tag:normalise](https://unhead.unjs.io/docs/head/api/hooks/tag-normalise) - Called when a tag is being normalized
- [tags:beforeResolve](https://unhead.unjs.io/docs/head/api/hooks/tags-before-resolve) - Called before tags are resolved for rendering
- [tags:resolve](https://unhead.unjs.io/docs/head/api/hooks/tags-resolve) - Called when tags are being resolved for rendering
- [tags:afterResolve](https://unhead.unjs.io/docs/head/api/hooks/tags-after-resolve) - Called after tags have been resolved

### [How do I hook into DOM rendering?](#how-do-i-hook-into-dom-rendering)

- [dom:beforeRender](https://unhead.unjs.io/docs/head/api/hooks/dom-before-render) - Called before rendering to the DOM (synchronous)

### [How do I hook into server-side rendering?](#how-do-i-hook-into-server-side-rendering)

- [ssr:beforeRender](https://unhead.unjs.io/docs/head/api/hooks/ssr-before-render) - Called before server-side rendering
- [ssr:render](https://unhead.unjs.io/docs/head/api/hooks/ssr-render) - Called during server-side rendering
- [ssr:rendered](https://unhead.unjs.io/docs/head/api/hooks/ssr-rendered) - Called after server-side rendering

### [How do I hook into script loading?](#how-do-i-hook-into-script-loading)

- [script:updated](https://unhead.unjs.io/docs/head/api/hooks/script-updated) - Called when a script instance is updated

[Edit this page](https://github.com/unjs/unhead/edit/main/docs/head/7.api/0.get-started/overview.md)

[Markdown For LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/head/7.api/0.get-started/overview.md)

Did this page help you?

[Validate Catch common SEO, performance, and head tag mistakes. Validates URLs, meta tags, Open Graph, Twitter Cards, web vitals anti-patterns, and detects typos with fuzzy matching.](https://unhead.unjs.io/docs/head/guides/plugins/validate) [useHead() Manage document head tags with useHead(). Set titles, meta tags, scripts, and styles with full TypeScript support and reactive updates.](https://unhead.unjs.io/docs/head/api/composables/use-head)

On this page

- [What composables are available?](#what-composables-are-available)
- [How do I create plugins?](#how-do-i-create-plugins)
- [What hooks can I use?](#what-hooks-can-i-use)

[GitHub](https://github.com/unjs/unhead) [ Discord](https://discord.com/invite/275MBUBvgP)

[ /llms.txt](https://unhead.unjs.io/llms.txt)

[Part of the UnJS ecosystem](https://unjs.io/)

### Head Management

- [Getting Started](https://unhead.unjs.io/docs/solid-js/head/guides/get-started/overview)
- [useHead](https://unhead.unjs.io/docs/solid-js/head/api/composables/use-head)
- [useSeoMeta](https://unhead.unjs.io/docs/solid-js/head/api/composables/use-seo-meta)
- [useHeadSafe](https://unhead.unjs.io/docs/solid-js/head/api/composables/use-head-safe)
- [useScript](https://unhead.unjs.io/docs/solid-js/head/api/composables/use-script)

### Schema.org

- [Getting Started](https://unhead.unjs.io/docs/solid-js/schema-org/guides/get-started/overview)
- [useSchemaOrg](https://unhead.unjs.io/docs/solid-js/schema-org/api/composables/use-schema-org)
- [Nodes](https://unhead.unjs.io/docs/solid-js/schema-org/guides/core-concepts/nodes)
- [Recipes](https://unhead.unjs.io/docs/solid-js/schema-org/guides/recipes/identity)

### Guides

- [Titles](https://unhead.unjs.io/docs/solid-js/head/guides/core-concepts/titles)
- [Streaming SSR](https://unhead.unjs.io/docs/solid-js/head/guides/core-concepts/streaming)
- [DOM Events](https://unhead.unjs.io/docs/solid-js/head/guides/core-concepts/dom-event-handling)
- [Plugins](https://unhead.unjs.io/docs/solid-js/head/guides/plugins/template-params)

### Tools

- [Meta Tag Generator](https://unhead.unjs.io/tools/meta-tag-generator)
- [OG Image Generator](https://unhead.unjs.io/tools/og-image-generator)
- [Schema.org Generator](https://unhead.unjs.io/tools/schema-generator)
- [Capo.js Analyzer](https://unhead.unjs.io/tools/capo-analyzer)

### Articles

- [What is Capo.js?](https://unhead.unjs.io/learn/guides/what-is-capo)

### Research

- [State of <head> in 2026](https://unhead.unjs.io/learn/research/state-of-head-2026)
- [Streaming Head Performance](https://unhead.unjs.io/learn/research/streaming-head-performance)
- [Capo.js Performance Research](https://unhead.unjs.io/learn/research/capo-performance-research)

Copyright © 2025-2026 Harlan Wilton - [MIT License](https://github.com/unjs/unhead/blob/main/license)