--- title: "Organization Schema - JSON-LD Guide & Examples · Unhead" canonical_url: "https://unhead.unjs.io/docs/nuxt/schema-org/api/schema/organization" last_updated: "2026-07-21T16:52:18.182Z" meta: description: "Add Organization structured data with Unhead. Describe a company identity, logo, address, contact details, and sameAs profiles." "og:description": "Add Organization structured data with Unhead. Describe a company identity, logo, address, contact details, and sameAs profiles." "og:title": "Organization Schema - JSON-LD Guide & Examples · Unhead" --- Home ` Unhead on GitHub Switch to NuxtSwitch to TypeScriptSwitch to VueSwitch to ReactSwitch to SvelteSwitch to Solid.jsSwitch to Angular **Schema** # **Organization Schema - JSON-LD Guide & Examples** [Copy for LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/9.schema/organization.md) [**~~Organization structured data~~**](https://developers.google.com/search/docs/appearance/structured-data/organization) can help Google understand administrative details and disambiguate a company or brand. Unhead also references the identity from related nodes such as Article, WebSite, and Product. ## JSON-LD Example ``` { "@context": "https://schema.org", "@type": "Organization", "name": "Acme Corp", "url": "https://acme.com", "logo": "https://acme.com/logo.png", "sameAs": [ "https://twitter.com/acme", "https://github.com/acme", "https://linkedin.com/company/acme" ], "contactPoint": { "@type": "ContactPoint", "telephone": "+1-800-555-0199", "contactType": "customer service" } } ``` Use the [**~~Schema.org Generator~~**](https://unhead.unjs.io/tools/schema-generator) to build your structured data visually. ## Schema.org Organization - **Type**: `defineOrganization>(input?: Organization & T)` Describes an organization (a company, business, or institution). It is most commonly used to identify the publisher of a WebSite. ## Useful Links - [**~~Organization - Schema.org~~**](https://schema.org/Organization) - [**~~Organization Schema Markup - Google Search Central~~**](https://developers.google.com/search/docs/appearance/structured-data/organization) - [**~~Choose an Identity - Organization~~**](https://unhead.unjs.io/docs/schema-org/guides/recipes/identity#organization) ## Unhead input property The Unhead `**Organization**` interface requires `**name**` when you pass an object. Google has no required Organization properties and instead recommends supplying every relevant property. - **name** `**string**` The name of the business. ## Recommended Properties - **logo** `**NodeRelation**` A logo image URL, which may be relative to the site root. - **sameAs** `**string[]**` An array of URLs for other profiles or pages that identify the Organization. - **telephone** `**string**` The telephone number of the organization. - **email** `**string**` The email address of the organization. - **foundingDate** `**string**` The date the organization was founded. ## Examples ### Minimal ``` defineOrganization({ name: 'My Site', logo: '/logo.png', sameAs: [ 'https://www.facebook.com/my-site', 'https://twitter.com/my-site', 'https://www.instagram.com/my-site', 'https://www.youtube.com/my-site', ] }) ``` ## Defaults - **@type**: `**Organization**` - **@id**: `**${canonicalHost}#identity**` - **url**: `**canonicalHost**` ## Resolves See [**~~Global Resolves~~**](https://unhead.unjs.io/docs/schema-org/guides/get-started/overview#how-does-schemaorg-get-page-data) for full context. - address as `**PostalAddress**` object - resolves a string `**logo**` URL into an ImageObject with the ID `**#logo**` For example: ``` defineOrganization({ name: 'Nuxt.js', logo: '/img/logo.png', }) ``` The logo URL resolves into an ImageObject with the ID `**#logo**`. The primary identity references related content, while a compact Organization node at `**#organization**` carries the absolute logo URL for Google's organization markup. ``` { "@context": "https://schema.org", "@graph": [ { "@id": "https://nuxtjs.org/#identity", "@type": "Organization", "name": "Nuxt.js", "url": "https://nuxtjs.org/" }, { "@id": "https://nuxtjs.org/#logo", "@type": "ImageObject", "caption": "Nuxt.js", "contentUrl": "https://nuxtjs.org/img/logo.png", "url": "https://nuxtjs.org/img/logo.png" }, { "@id": "https://nuxtjs.org/#organization", "@type": "Organization", "logo": "https://nuxtjs.org/img/logo.png", "name": "Nuxt.js", "url": "https://nuxtjs.org/" } ] } ``` ## Types ``` /** * An organization such as a school, NGO, corporation, club, etc. */ export interface OrganizationSimple extends Thing { /** * A reference-by-ID to an image of the organization's logo. * * - The image must be 112x112px, at a minimum. * - Make sure the image looks how you intend it to look on a purely white background * (for example, if the logo is mostly white or gray, * it may not look how you want it to look when displayed on a white background). */ logo?: NodeRelation /** * The site's home URL. */ url?: string /** * The name of the Organization. */ name: string /** * An array of URLs representing declared social/authoritative profiles of the organization * (e.g., a Wikipedia page, or Facebook profile). */ sameAs?: Arrayable /** * An array of images which represent the organization (including the logo), referenced by ID. */ image?: NodeRelations /** * A reference-by-ID to a PostalAddress piece. */ address?: NodeRelations /** * The telephone number of the organization. */ telephone?: string /** * The email address of the organization. */ email?: string /** * The date the organization was founded. */ foundingDate?: string } export interface Organization extends OrganizationSimple {} ``` ## Related Schemas - [**~~Person~~**](https://unhead.unjs.io/docs/schema-org/api/schema/person): Organization members - [**~~LocalBusiness~~**](https://unhead.unjs.io/docs/schema-org/api/schema/local-business): Physical locations [~~Edit this page~~](https://github.com/unjs/unhead/edit/main/docs/schema-org/5.api/9.schema/organization.md) [~~Markdown For LLMs~~](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/9.schema/organization.md) **Did this page help you? ** [**Music Recording Schema** Use defineMusicRecording() to describe a song or track, including its artist, album, duration, ISRC, audio, and release date.](https://unhead.unjs.io/docs/schema-org/api/schema/music-recording) [**Person Schema** Use definePerson() to add Person structured data. Establish author identity for articles and content with name, image, and social profile links.](https://unhead.unjs.io/docs/schema-org/api/schema/person) **On this page ** - [JSON-LD Example](#json-ld-example) - [Schema.org Organization](#schemaorg-organization) - [Useful Links](#useful-links) - [Unhead input property](#unhead-input-property) - [Recommended Properties](#recommended-properties) - [Examples](#examples) - [Defaults](#defaults) - [Resolves](#resolves) - [Types](#types) - [Related Schemas](#related-schemas)