Install Unhead Schema.org · Unhead

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

- [Docs](https://unhead.unjs.io/docs/vue/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/vue/head/guides/get-started/overview)

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

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

Vue

- [Switch to Vue](https://unhead.unjs.io/docs/vue/head/guides/get-started/installation)
- [Switch to TypeScript](https://unhead.unjs.io/docs/typescript/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)

v3 (stable)

Schema.org

- [Discord Support](https://discord.com/invite/275MBUBvgP)
- [Vue Playground](https://stackblitz.com/edit/github-1ftqrmwn)

- Get Started
  - [Introduction](https://unhead.unjs.io/docs/vue/schema-org/guides/get-started/overview)
- Core Concepts
  - [Deduping Nodes](https://unhead.unjs.io/docs/vue/schema-org/guides/core-concepts/deduping-nodes)
  - [Supported Nodes](https://unhead.unjs.io/docs/vue/schema-org/guides/core-concepts/nodes)
  - [Schema.org Params](https://unhead.unjs.io/docs/vue/schema-org/guides/core-concepts/params)
- Recipes
  - [Custom Nodes](https://unhead.unjs.io/docs/vue/schema-org/guides/recipes/custom-nodes)
  - [Identity](https://unhead.unjs.io/docs/vue/schema-org/guides/recipes/identity)
  - [Blog](https://unhead.unjs.io/docs/vue/schema-org/guides/recipes/blog)
  - [Breadcrumbs](https://unhead.unjs.io/docs/vue/schema-org/guides/recipes/breadcrumbs)
  - [eCommerce](https://unhead.unjs.io/docs/vue/schema-org/guides/recipes/e-commerce)
  - [FAQ](https://unhead.unjs.io/docs/vue/schema-org/guides/recipes/faq)
  - [How To](https://unhead.unjs.io/docs/vue/schema-org/guides/recipes/how-to)
  - [Site Search](https://unhead.unjs.io/docs/vue/schema-org/guides/recipes/site-search)

Get Started

# Install Unhead Schema.org

[Copy for LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/0.vue/schema-org/guides/0.get-started/0.installation.md)

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

- [Demos](#demos)
- [Setup](#setup)
- [Recommended: Vite Plugin](#recommended-vite-plugin)
- [Optional: Auto-Imports](#optional-auto-imports)
- [Next Steps](#next-steps)

Using  Nuxt? Check out [nuxt-schema-org](https://nuxtseo.com/schema-org).

## [Demos](#demos)

[Vite SPA](https://stackblitz.com/edit/vitejs-vite-xbb1fa) [Vite + Vite SSR](https://stackblitz.com/edit/vitejs-vite-vsf3sy) ## [Setup](#setup)

1. Install `@unhead/schema-org` dependency to your project:

yarn

npm

pnpm

```
yarn add -D @unhead/schema-org
```

```
npm install -D @unhead/schema-org
```

```
pnpm add -D @unhead/schema-org
```

1. Configure the Schema.org params

At a minimum you should provide a [host](https://developers.google.com/search/docs/advanced/crawling/consolidate-duplicate-urls).

```
import { UnheadSchemaOrg } from '@unhead/schema-org/vue'

useHead({
  templateParams: {
    schemaOrg: {
      host: 'https://example.com',
    }
  }
})
```

See the [Schema.org Params](https://unhead.unjs.io/docs/schema-org/guides/core-concepts/params) for all options you can pass on `schemaOrg`.

### [3. Add Site Schema.org](#_3-add-site-schemaorg)

```
import { UnheadSchemaOrg } from '@unhead/schema-org/vue'

useSchemaOrg([
  // @todo Select Identity: http://unhead.unjs.io/schema-org/recipes/identity
  defineWebSite({
    name: 'My Awesome Website',
  }),
  defineWebPage(),
])
```

## [Recommended: Vite Plugin](#recommended-vite-plugin)

If you're using Vite, the [Vite plugin](https://unhead.unjs.io/docs/head/guides/build-plugins/overview) optimizes your production bundle by tree-shaking server-only code and transforming head composables at build time:

```
import vue from '@vitejs/plugin-vue'
import { Unhead } from '@unhead/vue/vite'

export default defineConfig({
  plugins: [vue(), Unhead()],
})
```

## [Optional: Auto-Imports](#optional-auto-imports)

If you're using Vite with [unplugin-vue-components](https://github.com/antfu/unplugin-vue-components) or [unplugin-auto-import](https://github.com/antfu/unplugin-auto-import), you can optionally configure automatic imports.

Modify your `vite.config.ts` to get the auto-imports.

@unhead/schema-org

@unhead/schema-org/vue

```
import { schemaAutoImports, SchemaOrgResolver } from '@unhead/schema-org'

export default defineConfig({
  plugins: [
    // ...
    Components({
      // ...
      resolvers: [
        // auto-import schema-org components
        SchemaOrgResolver(),
      ],
    }),
    AutoImport({
      // ...
      imports: [
        // auto-import schema-org composables
        {
          '@unhead/schema-org': schemaAutoImports,
        },
      ],
    }),
  ]
})
```

```
import { schemaAutoImports, SchemaOrgResolver } from '@unhead/schema-org/vue'

export default defineConfig({
  plugins: [
    // ...
    Components({
      // ...
      resolvers: [
        // auto-import schema-org components
        SchemaOrgResolver(),
      ],
    }),
    AutoImport({
      // ...
      imports: [
        // auto-import schema-org composables
        {
          '@unhead/schema-org/vue': schemaAutoImports,
        },
      ],
    }),
  ]
})
```

## [Next Steps](#next-steps)

Your Vue app is now serving basic Schema.org, congrats!

The next steps are:

1. Choose an [Identity](https://unhead.unjs.io/docs/schema-org/guides/recipes/identity)
2. Set up your pages for [Schema.org Params](https://unhead.unjs.io/docs/schema-org/guides/core-concepts/params)
3. Then feel free to follow some recipes:

- [Breadcrumbs](https://unhead.unjs.io/docs/schema-org/guides/recipes/breadcrumbs)
- [FAQ Page](https://unhead.unjs.io/docs/schema-org/guides/recipes/faq)
- [Site Search](https://unhead.unjs.io/docs/schema-org/guides/recipes/site-search)

[Edit this page](https://github.com/unjs/unhead/edit/main/docs/0.vue/schema-org/guides/0.get-started/0.installation.md)

[Markdown For LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/0.vue/schema-org/guides/0.get-started/0.installation.md)

Did this page help you?

[Streaming Stream head tags as async components resolve during Vue SSR](https://unhead.unjs.io/docs/vue/head/guides/core-concepts/streaming) [Vue Components Schema.org Vue components API (deprecated). Use composables like useSchemaOrg() instead for better TypeScript support.](https://unhead.unjs.io/docs/vue/schema-org/guides/core-concepts/vue-components)

On this page

- [Demos](#demos)
- [Setup](#setup)
- [Recommended: Vite Plugin](#recommended-vite-plugin)
- [Optional: Auto-Imports](#optional-auto-imports)
- [Next Steps](#next-steps)

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

### Schema.org

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

### Guides

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