---
title: Schema.org Params
description: Configure site-wide defaults for Schema.org with host, inLanguage, currency, and trailingSlash. Automatically cascade to all schema 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?

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

::code-group

```ts [useHead]
import { useHead } from '@unhead/dynamic-import'

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

::

## Which Params Are Available?

### `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`

- **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`

- **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`

- **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`

- **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`

- **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?

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.

```ts
useHead({
  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
])
```