Deduping Nodes · Unhead [Unhead Home](https://unhead.unjs.io/ "Home") - [Docs](https://unhead.unjs.io/docs/svelte/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/svelte/head/guides/get-started/overview) [API](https://unhead.unjs.io/docs/svelte/head/api/get-started/overview) [Releases](https://unhead.unjs.io/docs/svelte/releases/v3) Svelte - [Switch to Svelte](https://unhead.unjs.io/docs/svelte/schema-org/guides/core-concepts/deduping-nodes) - [Switch to TypeScript](https://unhead.unjs.io/docs/typescript/schema-org/guides/core-concepts/deduping-nodes) - [Switch to Vue](https://unhead.unjs.io/docs/vue/schema-org/guides/core-concepts/deduping-nodes) - [Switch to React](https://unhead.unjs.io/docs/react/schema-org/guides/core-concepts/deduping-nodes) - [Switch to Solid.js](https://unhead.unjs.io/docs/solid-js/schema-org/guides/core-concepts/deduping-nodes) - [Switch to Angular](https://unhead.unjs.io/docs/angular/schema-org/guides/core-concepts/deduping-nodes) - [Switch to Nuxt](https://unhead.unjs.io/docs/nuxt/schema-org/guides/core-concepts/deduping-nodes) v3 (stable) Schema.org - [Discord Support](https://discord.com/invite/275MBUBvgP) - [Svelte Playground](https://stackblitz.com/edit/github-ckbygkxk) - Get Started - [Introduction](https://unhead.unjs.io/docs/svelte/schema-org/guides/get-started/overview) - Core Concepts - [Deduping Nodes](https://unhead.unjs.io/docs/svelte/schema-org/guides/core-concepts/deduping-nodes) - [Supported Nodes](https://unhead.unjs.io/docs/svelte/schema-org/guides/core-concepts/nodes) - [Schema.org Params](https://unhead.unjs.io/docs/svelte/schema-org/guides/core-concepts/params) - Recipes - [Custom Nodes](https://unhead.unjs.io/docs/svelte/schema-org/guides/recipes/custom-nodes) - [Identity](https://unhead.unjs.io/docs/svelte/schema-org/guides/recipes/identity) - [Blog](https://unhead.unjs.io/docs/svelte/schema-org/guides/recipes/blog) - [Breadcrumbs](https://unhead.unjs.io/docs/svelte/schema-org/guides/recipes/breadcrumbs) - [eCommerce](https://unhead.unjs.io/docs/svelte/schema-org/guides/recipes/e-commerce) - [FAQ](https://unhead.unjs.io/docs/svelte/schema-org/guides/recipes/faq) - [How To](https://unhead.unjs.io/docs/svelte/schema-org/guides/recipes/how-to) - [Site Search](https://unhead.unjs.io/docs/svelte/schema-org/guides/recipes/site-search) Core Concepts # Deduping Nodes [Copy for LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/2.guides/1.core-concepts/2.deduping-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 - [How does node deduplication work?](#how-does-node-deduplication-work) - [How do I add multiple nodes of the same type?](#how-do-i-add-multiple-nodes-of-the-same-type) - [How do I replace a node instead of merging?](#how-do-i-replace-a-node-instead-of-merging) **Quick Answer:** Schema.org nodes are automatically deduplicated by their `@id`. Only one node of each type (like `WebPage`) can exist by default. Later definitions merge with earlier ones unless you specify a custom `@id`. ## [How does node deduplication work?](#how-does-node-deduplication-work) When generating many of the Schema.org nodes a default global `@id` is used to help with best practices. For example: ``` import { defineOrganization, useSchemaOrg } from '@unhead/schema-org/svelte' useSchemaOrg([ defineOrganization() // generates the nodes with an #identity id ]) ``` This allows the node relations to be automatically mapped for best practices. ``` import { defineWebPage, useSchemaOrg } from '@unhead/schema-org/svelte' useSchemaOrg([ defineWebPage() // knows to link the #identity id ]) ``` ## [How do I add multiple nodes of the same type?](#how-do-i-add-multiple-nodes-of-the-same-type) The default `@id` can prevent having multiple nodes of the same type. Provide your own `@id` to create separate nodes: ``` import { defineOrganization, useSchemaOrg } from '@unhead/schema-org/svelte' useSchemaOrg([ defineOrganization({ '@id': '#some-company' }) ]) ``` ## [How do I replace a node instead of merging?](#how-do-i-replace-a-node-instead-of-merging) Use `tagDuplicateStrategy: 'replace'` to fully replace a node instead of merging properties: ``` import { defineOrganization, useSchemaOrg } from '@unhead/schema-org/svelte' useSchemaOrg([ defineOrganization({ '@id': '#some-company', 'name': 'Bar Company', 'url': 'https://bar.com', }), ]) useSchemaOrg([ defineOrganization({ '@id': '#some-company', 'name': 'Foo Company', }) ], { tagDuplicateStrategy: 'replace' }) // Replaced! // { // '@id': '#some-company', // name: 'Foo Company', // } ``` [Edit this page](https://github.com/unjs/unhead/edit/main/docs/schema-org/2.guides/1.core-concepts/2.deduping-nodes.md) [Markdown For LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/2.guides/1.core-concepts/2.deduping-nodes.md) Did this page help you? [Introduction Generate JSON-LD structured data for Google Rich Results. TypeScript functions like defineArticle() and defineProduct() with automatic validation.](https://unhead.unjs.io/docs/schema-org/guides/get-started/overview) [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) On this page - [How does node deduplication work?](#how-does-node-deduplication-work) - [How do I add multiple nodes of the same type?](#how-do-i-add-multiple-nodes-of-the-same-type) - [How do I replace a node instead of merging?](#how-do-i-replace-a-node-instead-of-merging) [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/svelte/head/guides/get-started/overview) - [useHead](https://unhead.unjs.io/docs/svelte/head/api/composables/use-head) - [useSeoMeta](https://unhead.unjs.io/docs/svelte/head/api/composables/use-seo-meta) - [useHeadSafe](https://unhead.unjs.io/docs/svelte/head/api/composables/use-head-safe) - [useScript](https://unhead.unjs.io/docs/svelte/head/api/composables/use-script) ### Schema.org - [Getting Started](https://unhead.unjs.io/docs/svelte/schema-org/guides/get-started/overview) - [useSchemaOrg](https://unhead.unjs.io/docs/svelte/schema-org/api/composables/use-schema-org) - [Nodes](https://unhead.unjs.io/docs/svelte/schema-org/guides/core-concepts/nodes) - [Recipes](https://unhead.unjs.io/docs/svelte/schema-org/guides/recipes/identity) ### Guides - [Titles](https://unhead.unjs.io/docs/svelte/head/guides/core-concepts/titles) - [Streaming SSR](https://unhead.unjs.io/docs/svelte/head/guides/core-concepts/streaming) - [DOM Events](https://unhead.unjs.io/docs/svelte/head/guides/core-concepts/dom-event-handling) - [Plugins](https://unhead.unjs.io/docs/svelte/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 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)