Schema.org Params · Unhead

[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)

Search…```k`` /`

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

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

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

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

TypeScript

- [Switch to TypeScript](https://unhead.unjs.io/docs/typescript/schema-org/guides/core-concepts/params)
- [Switch to Vue](https://unhead.unjs.io/docs/vue/schema-org/guides/core-concepts/params)
- [Switch to React](https://unhead.unjs.io/docs/react/schema-org/guides/core-concepts/params)
- [Switch to Svelte](https://unhead.unjs.io/docs/svelte/schema-org/guides/core-concepts/params)
- [Switch to Solid.js](https://unhead.unjs.io/docs/solid-js/schema-org/guides/core-concepts/params)
- [Switch to Angular](https://unhead.unjs.io/docs/angular/schema-org/guides/core-concepts/params)
- [Switch to Nuxt](https://unhead.unjs.io/docs/nuxt/schema-org/guides/core-concepts/params)

v3 (stable)

Schema.org

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

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

Core Concepts

# Schema.org Params

[Copy for LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/2.guides/1.core-concepts/3.params.md)

Last updated Jan 19, 2026 by [Harlan Wilton](https://github.com/harlan-zw) in [docs: sync](https://github.com/unjs/unhead/commit/d2f86454774aa60706628b46a850653e1e4d56d9).

On this page

- [What Are Schema.org Params?](#what-are-schemaorg-params)
- [Which Params Are Available?](#which-params-are-available)
- [How Do Params Cascade to Nodes?](#how-do-params-cascade-to-nodes)

**Quick Answer:** Schema.org params configure site-wide defaults like `host`, `path`, `currency`, and `inLanguage`. Set them once and they're automatically applied to all schema nodes.

## [What Are Schema.org Params?](#what-are-schemaorg-params)

Params let you configure multiple Schema.org nodes at once, reducing boilerplate. Use the `schemaOrg` option on templateParams.

useHead

```
import { useHead } from 'unhead'

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

## [Which Params Are Available?](#which-params-are-available)

### [`tagPosition`](#tagposition)

- **type**: `string`
- **default**: `bodyClose`The position of the Schema.org script tag. This is useful if you want to load the script in the body of your page.

### [`host`](#host)

- **type**: `string`The production URL of your site. This allows the client to generate all URLs for you and is important to set correctly.

### [`path`](#path)

- **type**: `string`
- **default**: `window.location.pathname`The path of the current page. This allows the client to generate all URLs for you and is important to set correctly.

### [`inLanguage`](#inlanguage)

- **type**: `string`
- **default**: `en`Will set the `isLanguage` to this value for any Schema which uses it. Should be a valid language code, i.e `en-AU`

### [`trailingSlash`](#trailingslash)

- **type**: `boolean`
- **default**: `false`Whether to add a trailing slash to the URL. This is important for Google to understand the canonical URL of your page.

### [`currency`](#currency)

- **type**: `string`
- **default**: `undefined`Default currency for Product, Offer, and other commerce-related schemas. Use ISO 4217 format, e.g., `USD`, `EUR`, `GBP`.

## [How Do Params Cascade to Nodes?](#how-do-params-cascade-to-nodes)

When you set a param like `host` or `inLanguage`, it automatically applies to all Schema.org nodes that support that property. This means you define your site defaults once and every `defineWebPage`, `defineArticle`, `defineProduct`, etc. inherits them without repetition.

```
useHead(unheadInstance, {
  templateParams: {
    schemaOrg: {
      host: 'https://example.com',
      inLanguage: 'en-AU',
      currency: 'AUD'
    }
  }
})

// All schema nodes now use these defaults automatically
useSchemaOrg([
  defineWebPage(), // inherits host, inLanguage
  defineProduct({ name: 'Widget', offers: { price: 99 } }) // inherits currency
])
```

[Edit this page](https://github.com/unjs/unhead/edit/main/docs/schema-org/2.guides/1.core-concepts/3.params.md)

[Markdown For LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/2.guides/1.core-concepts/3.params.md)

Did this page help you?

[Supported Nodes Schema.org nodes for Google Rich Results with define* functions. Article, Product, Event, Recipe, FAQ, and 30+ more types with TypeScript validation.](https://unhead.unjs.io/docs/schema-org/guides/core-concepts/nodes) [Custom Nodes Create custom Schema.org types not in built-in helpers. Pass plain objects to useSchemaOrg() with TypeScript support via schema-dts.](https://unhead.unjs.io/docs/schema-org/guides/recipes/custom-nodes)

On this page

- [What Are Schema.org Params?](#what-are-schemaorg-params)
- [Which Params Are Available?](#which-params-are-available)
- [How Do Params Cascade to Nodes?](#how-do-params-cascade-to-nodes)

[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)