---
title: "Install Unhead Schema.org"
description: "Add Schema.org structured data to Svelte apps with the @unhead/schema-org Svelte adapter."
canonical_url: "https://unhead.unjs.io/docs/svelte/schema-org/guides/get-started/installation"
last_updated: "2026-07-20T12:15:06.570Z"
---

## Setup

### 1. Install the Package

Install `@unhead/schema-org` in your project:

<code-group>

```bash [yarn]
yarn add @unhead/schema-org
```

```bash [npm]
npm install @unhead/schema-org
```

```bash [pnpm]
pnpm add @unhead/schema-org
```

</code-group>

### 2. Configure Schema.org Params

At a minimum, provide a [`host`](/docs/schema-org/guides/core-concepts/params):

```svelte
<script lang="ts">
  import { useHead } from '@unhead/svelte'

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

See [Schema.org Params](/docs/schema-org/guides/core-concepts/params) for all available options.

### 3. Add Site Schema.org

Import from the Svelte adapter so `useSchemaOrg()` gets the head instance from Svelte context and registers component cleanup:

```svelte
<script lang="ts">
  import { defineWebPage, defineWebSite, useSchemaOrg } from '@unhead/schema-org/svelte'

  useSchemaOrg([
    defineWebSite({ name: 'Example Site' }),
    defineWebPage(),
  ])
</script>
```

## Recommended: Vite Plugin

The [Vite plugin](/docs/head/guides/build-plugins/overview) can tree-shake server-only code and transform head composables at build time:

```ts [vite.config.ts]
import { svelte } from '@sveltejs/vite-plugin-svelte'
import { Unhead } from '@unhead/svelte/vite'
import { defineConfig } from 'vite'

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

## Optional: Auto-Imports

The Svelte adapter exports an auto-import preset:

```ts [vite.config.ts]
import { schemaOrgAutoImports } from '@unhead/schema-org/svelte'
import AutoImport from 'unplugin-auto-import/vite'

export default defineConfig({
  plugins: [
    AutoImport({
      imports: schemaOrgAutoImports,
    }),
  ],
})
```

## Next Steps

1. Choose an [Identity](/docs/schema-org/guides/recipes/identity)
2. Set up your pages with [Schema.org Params](/docs/schema-org/guides/core-concepts/params)
3. Follow a recipe:

- [Breadcrumbs](/docs/schema-org/guides/recipes/breadcrumbs)
- [FAQ Page](/docs/schema-org/guides/recipes/faq)
- [Site Search](/docs/schema-org/guides/recipes/site-search)