Unhead · Full stack <head> package

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

- [Docs](https://unhead.unjs.io/docs/typescript/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)

`/`

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

[🌊 Unhead v3 is here](https://unhead.unjs.io/docs/releases/v3)

# The full stack <head> package for any framework.

Unhead wraps your document template, improving reactive SSR JavaScript framework SEO and performance.

[Get Started](https://unhead.unjs.io/docs/typescript/head/guides/get-started/overview) [ Install Unhead](https://unhead.unjs.io/docs/typescript/head/guides/get-started/installation)

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

Unhead Principles

## Why Unhead

01

### Complete Developer Experience

- [useHead()](https://unhead.unjs.io/docs/typescript/head/api/composables/use-head) with type narrowing, deduping, and tag merging
- Flat [useSeoMeta()](https://unhead.unjs.io/docs/typescript/head/api/composables/use-seo-meta) for 100+ meta tags
- [useScript()](https://unhead.unjs.io/docs/typescript/head/api/composables/use-script) for performant third party loading
- [useSchemaOrg()](https://unhead.unjs.io/docs/typescript/schema-org/api/composables/use-schema-org) for automatic Schema.org graphs
- Plugins for tag validation, canonical URLs, and 7 more

02

### Built for Performance

- ~4.4kb gzipped, tree shakable utilities
- Built in HTML minification
- [Streaming SSR](https://unhead.unjs.io/docs/releases/v3) with head tags pushed per chunk
- Automatic [Capo.js](https://unhead.unjs.io/learn/guides/what-is-capo) head tag ordering

03

### Any Framework / Any Bundler

- Vue, React, Solid.js, Svelte, and Angular
- Vite, Webpack, Rollup, and more
- Built in [Vite Devtools](https://unhead.unjs.io/docs/head/guides/debugging) integration
- Hook into every stage of head resolution

## Hello useHead()

Unhead aims to provide bullet-proof primitives for a minimal yet powerful API surface.

## Built For Reactive Lifecycles

All side effects are tracked so that unmounting a component will revert its head modifications and reactive updates can be made at any time.

Mount

Component Not Mounted

## Optimized SEO Tags

Nail your SEO with foolproof flat meta config and the simplest Schema.org you've ever worked with.

## Making Websites Faster

Unhead ships to be tree shaken with client and server export paths.

### Optimized Head tag ordering

Unhead ships with a default head tag order that is optimized for SEO and performance.

Enable Capo.js

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

## Up To Date. Always.

Unhead was started at the end of 2022 and has received continuous bug fixes and feature improvements from the community.

0

Commits

0

Issues Closed

0

Contributors

341K downloadsper day, on average

Unhead is used and trusted by thousands of developers and companies around the world.

12M

Downloads/ month

0

Total Stars

## Funded by the community

Unhead is completely free and open-source due to the generous support of the community.

[Become a sponsor](https://github.com/sponsors/harlan-zw)

Top Sponsors

Gold Sponsors

Backers

[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/typescript/head/guides/get-started/overview)
- [useHead](https://unhead.unjs.io/docs/typescript/head/api/composables/use-head)
- [useSeoMeta](https://unhead.unjs.io/docs/typescript/head/api/composables/use-seo-meta)
- [useHeadSafe](https://unhead.unjs.io/docs/typescript/head/api/composables/use-head-safe)
- [useScript](https://unhead.unjs.io/docs/typescript/head/api/composables/use-script)

### Schema.org

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

### Guides

- [Titles](https://unhead.unjs.io/docs/typescript/head/guides/core-concepts/titles)
- [Streaming SSR](https://unhead.unjs.io/docs/typescript/head/guides/core-concepts/streaming)
- [DOM Events](https://unhead.unjs.io/docs/typescript/head/guides/core-concepts/dom-event-handling)
- [Plugins](https://unhead.unjs.io/docs/typescript/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)