---
title: "Custom Nodes"
description: "Create custom Schema.org types not in built-in helpers. Pass plain objects to useSchemaOrg() with TypeScript support via schema-dts."
canonical_url: "https://unhead.unjs.io/docs/schema-org/guides/recipes/custom-nodes"
last_updated: "2026-08-11T00:46:01.351Z"
---

Create custom Schema.org nodes by passing a plain object to `useSchemaOrg()`. Set `@type` to the schema type and add any valid Schema.org properties.

## Why Create Custom Schema.org Nodes?

Use a custom node when Unhead does not provide a dedicated helper for the Schema.org type you need.

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

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

useSchemaOrg([
  {
    '@type': 'SingleFamilyResidence',
    'numberOfRooms': 3,
    'occupancy': {
      '@type': 'QuantitativeValue',
      'maxValue': 5,
      'unitCode': 'C62',
    },
    'numberOfBathroomsTotal': 2,
    'floorSize': {
      '@type': 'QuantitativeValue',
      'value': 2000,
      'unitCode': 'FTK',
    },
    'petsAllowed': true,
  }
])
```

Schema.org expects [`QuantitativeValue`](https://schema.org/QuantitativeValue) objects for measurements such as [`occupancy`](https://schema.org/occupancy) and [`floorSize`](https://schema.org/floorSize). Keeping the value and unit together makes the JSON-LD unambiguous.

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

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

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

- [Setting Up Your Identity](/docs/schema-org/guides/recipes/identity): Define your organization/person
- [Blog Posts](/docs/schema-org/guides/recipes/blog): Article structured data
- [E-commerce](/docs/schema-org/guides/recipes/e-commerce): Product structured data