--- title: "useSchemaOrg() · Unhead" canonical_url: "https://unhead.unjs.io/docs/typescript/schema-org/api/composables/use-schema-org" last_updated: "2026-07-21T08:17:57.067Z" meta: description: "Add Schema.org structured data with useSchemaOrg(). Pass one or more typed or custom nodes and manage the resulting head entry." "og:description": "Add Schema.org structured data with useSchemaOrg(). Pass one or more typed or custom nodes and manage the resulting head entry." "og:title": "useSchemaOrg() · Unhead" --- Home ` Unhead on GitHub Switch to TypeScriptSwitch to VueSwitch to ReactSwitch to SvelteSwitch to Solid.jsSwitch to AngularSwitch to Nuxt **Composables** # **useSchemaOrg()** [Copy for LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/0.composables/0.use-schema-org.md) The `useSchemaOrg()` composable adds one or more Schema.org nodes to the page. ``` useSchemaOrg(input, options) ``` ## Example Define an Article node: ``` useSchemaOrg([ defineArticle({ headline: 'My Blog Post', image: '/images/post.jpg', datePublished: new Date(), }) ]) ``` ## Input The input accepts one Schema.org node or an array of nodes. Nodes can come from `**define***` helpers or be plain objects: ``` type UseSchemaOrgInput = Thing | Record | Array> ``` Available node functions include: - `**defineWebSite()**`: Site-level metadata - `**defineWebPage()**`: Page-level metadata - `**defineArticle()**`: Blog posts and articles - `**defineProduct()**`: E-commerce products - `**defineOrganization()**`: Company/organization info - `**definePerson()**`: Author/person profiles - `**defineBreadcrumb()**`: Navigation breadcrumbs - [**~~Browse all node helpers~~**](https://unhead.unjs.io/docs/schema-org/api/schema/article) ## Options The second parameter accepts `**HeadEntryOptions**` for the generated head entry: ``` export interface HeadEntryOptions { processTemplateParams?: boolean tagPriority?: number | 'critical' | 'high' | 'low' | \`before:${string}\` | \`after:${string}\` tagPosition?: 'head' | 'bodyClose' | 'bodyOpen' key?: string tagDuplicateStrategy?: 'replace' | 'merge' head?: Unhead onRendered?: (ctx: { renders: DomRenderTagContext[] }) => void | Promise } ``` ## Entry API The `**useSchemaOrg**` composable returns an entry that you can `**patch**` or `**dispose**`. ``` const schemaEntry = useSchemaOrg([ defineWebPage({ name: 'My Page' }) ]) // removes the schema nodes schemaEntry.dispose() ``` ## XSS safety The rendered JSON-LD is escaped so input cannot close the script element. Unhead does not validate node values or sanitize HTML contained in them. Do not pass unknown or untrusted third-party input without validating and sanitizing it first. ## Common Questions ### How do I add multiple schema types to a page? Pass an array to `**useSchemaOrg()**`; each item becomes a node in the graph. ``` useSchemaOrg([ defineWebPage({ name: 'Product Page' }), defineProduct({ name: 'Widget', offers: { price: 29.99, priceCurrency: 'USD' }, }), defineBreadcrumb({ itemListElement: [ { name: 'Home', item: '/' }, { name: 'Products', item: '/products' }, ] }) ]) ``` ### Do I need to set @id manually? Usually not. Helpers with primary roles use stable IDs, while other nodes receive numbered IDs. Set `**@id**` when you need a specific identity or several separately addressable nodes. ### How does Schema.org get page metadata? The plugin collects metadata from `****`, the meta description, the canonical link's host, `**og:image**`, `**<html lang>**`, and `**templateParams.schemaOrg**`. Each resolver chooses which values to inherit. ## See Also - [**~~useHead()~~**](https://unhead.unjs.io/docs/head/api/composables/use-head): General head management - [**~~useSeoMeta()~~**](https://unhead.unjs.io/docs/head/api/composables/use-seo-meta): SEO meta tag management - [**~~Schema.org Nodes~~**](https://unhead.unjs.io/docs/schema-org/guides/core-concepts/nodes): How to define and relate schema types [~~Edit this page~~](https://github.com/unjs/unhead/edit/main/docs/schema-org/5.api/0.composables/0.use-schema-org.md) [~~Markdown For LLMs~~](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/0.composables/0.use-schema-org.md) **Did this page help you? ** [**Site Search** Add a SearchAction to WebSite schema with defineSearchAction() and describe your internal search URL template.](https://unhead.unjs.io/docs/schema-org/guides/recipes/site-search) [**Article** Implement Article structured data with Unhead. JSON-LD examples for BlogPosting, NewsArticle, TechArticle with datePublished and author markup.](https://unhead.unjs.io/docs/schema-org/api/schema/article) **On this page ** - [Example](#example) - [Input](#input) - [Options](#options) - [Entry API](#entry-api) - [XSS safety](#xss-safety) - [Common Questions](#common-questions) - [See Also](#see-also)