---
title: "Custom Nodes · Unhead"
meta:
  "og:description": "Create custom Schema.org types not in built-in helpers. Pass plain objects to useSchemaOrg() with TypeScript support via schema-dts."
  "og:title": "Custom Nodes · Unhead"
  description: "Create custom Schema.org types not in built-in helpers. Pass plain objects to useSchemaOrg() with TypeScript support via schema-dts."
---

**Recipes**

# **Custom Nodes**

[Copy for LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/2.guides/4.recipes/0.custom-nodes.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 **

- [Why Create Custom Schema.org Nodes?](#why-create-custom-schemaorg-nodes)
- [How Do I Add TypeScript Support for Custom Nodes?](#how-do-i-add-typescript-support-for-custom-nodes)
- [Related Recipes](#related-recipes)

**Quick Answer:** Create custom Schema.org nodes by passing a plain object to `useSchemaOrg()`. Use `@type` for the schema type and any valid Schema.org properties.

## [Why Create Custom Schema.org Nodes?](#why-create-custom-schemaorg-nodes)

If you need to add a node that isn't officially implemented, you can provide it yourself. This is useful for:

- Niche schema types not covered by built-in helpers
- Emerging schema types not yet added to the library
- Highly specific industry schemas

Custom nodes are plain objects following the [**Schema.org specification**](https://schema.org/docs/full.html).

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

useSchemaOrg([
  {
    '@type': 'SingleFamilyResidence',
    'numberOfRooms': 3,
    'occupancy': 5,
    'numberOfBathroomsTotal': 2,
    'floorSize': '2000 sqft',
    'petsAllowed': true,
  }
])
```

## [How Do I Add TypeScript Support for Custom Nodes?](#how-do-i-add-typescript-support-for-custom-nodes)

Use [**schema-dts**](https://github.com/google/schema-dts) for full TypeScript support with custom nodes.

```
import type { DefinedTerm } from 'schema-dts'
import { useSchemaOrg } from '@unhead/schema-org/vue'

useSchemaOrg([
  <DefinedTerm> {
    '@type': 'DefinedTerm',
    'name': 'Unhead Schema.org',
    'description': 'Unhead Schema.org is a library for adding Schema.org to your application.',
    'inDefinedTermSet': {
      '@type': 'DefinedTermSet',
      'name': 'Schema.org Libraries',
    },
  }
])
```

## [Related Recipes](#related-recipes)

- [**Setting Up Your Identity**](https://unhead.unjs.io/docs/schema-org/guides/recipes/identity) - Define your organization/person
- [**Blog Posts**](https://unhead.unjs.io/docs/schema-org/guides/recipes/blog) - Article structured data
- [**eCommerce**](https://unhead.unjs.io/docs/schema-org/guides/recipes/e-commerce) - Product structured data

[Edit this page](https://github.com/unjs/unhead/edit/main/docs/schema-org/2.guides/4.recipes/0.custom-nodes.md)

[Markdown For LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/2.guides/4.recipes/0.custom-nodes.md)

**Did this page help you? **

[**Schema.org Params** Configure site-wide defaults for Schema.org with host, inLanguage, currency, and trailingSlash. Automatically cascade to all schema nodes.](https://unhead.unjs.io/docs/schema-org/guides/core-concepts/params) [**Identity** Set up Organization, Person, or LocalBusiness as your site identity. Enable Google Knowledge Panel and connect content to E-E-A-T signals.](https://unhead.unjs.io/docs/schema-org/guides/recipes/identity)

**On this page **

- [Why Create Custom Schema.org Nodes?](#why-create-custom-schemaorg-nodes)
- [How Do I Add TypeScript Support for Custom Nodes?](#how-do-i-add-typescript-support-for-custom-nodes)
- [Related Recipes](#related-recipes)