Organization Schema - JSON-LD Guide & Examples · Unhead

[Unhead Home](https://unhead.unjs.io/ "Home")

- [Docs](https://unhead.unjs.io/docs/typescript/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/typescript/head/guides/get-started/overview)

[API](https://unhead.unjs.io/docs/typescript/head/api/get-started/overview)

[Releases](https://unhead.unjs.io/docs/typescript/releases/v3)

TypeScript

- [Switch to TypeScript](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/organization)
- [Switch to Vue](https://unhead.unjs.io/docs/vue/schema-org/api/schema/organization)
- [Switch to React](https://unhead.unjs.io/docs/react/schema-org/api/schema/organization)
- [Switch to Svelte](https://unhead.unjs.io/docs/svelte/schema-org/api/schema/organization)
- [Switch to Solid.js](https://unhead.unjs.io/docs/solid-js/schema-org/api/schema/organization)
- [Switch to Angular](https://unhead.unjs.io/docs/angular/schema-org/api/schema/organization)
- [Switch to Nuxt](https://unhead.unjs.io/docs/nuxt/schema-org/api/schema/organization)

v3 (stable)

Schema.org

- [Discord Support](https://discord.com/invite/275MBUBvgP)
- [TypeScript Playground](https://stackblitz.com/edit/github-hhxywsb5)

- Composables
  - [`useSchemaOrg()`](https://unhead.unjs.io/docs/typescript/schema-org/api/composables/use-schema-org)
- Nodes
  - [Article](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/article)
  - [Book Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/book)
  - [Breadcrumb Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/breadcrumb)
  - [Comment Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/comment)
  - [Course Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/course)
  - [Dataset Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/dataset)
  - [Event Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/event)
  - [Food Establishment Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/food-establishment)
  - [HowTo](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/how-to)
  - [Image Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/image)
  - [ItemList](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/item-list)
  - [JobPosting](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/job-posting)
  - [LocalBusiness](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/local-business)
  - [Movie Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/movie)
  - [Music Album Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/music-album)
  - [Music Group Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/music-group)
  - [Music Playlist Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/music-playlist)
  - [Music Recording Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/music-recording)
  - [Organization](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/organization)
  - [Person Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/person)
  - [Podcast Episode Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/podcast-episode)
  - [Podcast Season Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/podcast-season)
  - [Podcast Series Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/podcast-series)
  - [Product Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/product)
  - [Question Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/question)
  - [Recipe Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/recipe)
  - [Service Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/service)
  - [SoftwareApplication](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/software-app)
  - [TV Episode Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/tv-episode)
  - [TV Season Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/tv-season)
  - [TV Series Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/tv-series)
  - [Video Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/video)
  - [WebPage Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/webpage)
  - [WebSite Schema](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/website)

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)

Last updated Mar 5, 2026 by [Harlan Wilton](https://github.com/harlan-zw) in [docs: improve SEO for schema.org pages, overview, and React Helmet migration (#675)](https://github.com/unjs/unhead/pull/675).

On this page

- [JSON-LD Example](#json-ld-example)
- [Schema.org Organization](#schemaorg-organization)
- [Useful Links](#useful-links)
- [Required properties](#required-properties)
- [Recommended Properties](#recommended-properties)
- [Examples](#examples)
- [Defaults](#defaults)
- [Resolves](#resolves)
- [Types](#types)
- [Related Schemas](#related-schemas)

Organization schema establishes your company or brand identity for search engines. It powers Google's Knowledge Panel, connects social profiles via `sameAs`, and serves as the publisher/author identity for other schema types like Article and LocalBusiness.

### [JSON-LD Example](#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"
  }
}
```

With Unhead, generate this using the `defineOrganization()` composable — see the [API reference](#schema-org-organization) below.

Use the [Schema.org Generator](https://unhead.unjs.io/tools/schema-generator) to build your structured data visually.

## [Schema.org Organization](#schemaorg-organization)

- **Type**: `defineOrganization(input?: Organization)`Describes an organization (a company, business or institution). Most commonly used to identify the publisher of a WebSite.

## [Useful Links](#useful-links)

- [Organization - Schema.org](https://schema.org/Organization)
- [Organization - Yoast](https://developer.yoast.com/features/schema/pieces/organization)
- [Choose an Identity - Organization](https://unhead.unjs.io/docs/schema-org/guides/recipes/identity#organization)

## [Required properties](#required-properties)

- **name** `string`The name of the business.

## [Recommended Properties](#recommended-properties)

- **logo** `SingleImageInput`Logo image url, can be relative to your site root.
- **sameAs** `string[]`An array of URLs that also belong to 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](#examples)

### [Minimal](#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](#defaults)

- **@type**: `Organization`
- **@id**: `${canonicalHost}#identity`
- **url**: `canonicalHost`

## [Resolves](#resolves)

See [Global Resolves](https://unhead.unjs.io/docs/schema-org/guides/get-started/overview#site-page-level-config) for full context.

- address as `PostalAddress` object
- resolves string urls of `logo` into a `ImageObject` with the id of `#logo`

For example:

```
defineOrganization({
  name: 'Nuxt.js',
  logo: '/img/logo.png',
})
```

Will resolve the logo url into an ImageObject with the id of `#logo`

```
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@id": "https://nuxtjs.org/#logo",
      "@type": "ImageObject",
      "url": "https://nuxtjs.org/img/logo.png"
    },
    {
      "@id": "https://nuxtjs.org/#identity",
      "@type": "Organization",
      "name": "Nuxt.js",
      "logo": {
        "@id": "https://nuxtjs.org/#logo"
      }
    }
  ]
}
```

## [Types](#types)

```
/**
 * An organization such as a school, NGO, corporation, club, etc.
 */
export interface Organization 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<ImageObject | string>
  /**
   * 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<string>
  /**
   * An array of images which represent the organization (including the logo ), referenced by ID.
   */
  image?: NodeRelations<ImageObject | string>
  /**
   * A reference-by-ID to an PostalAddress piece.
   */
  address?: NodeRelations<PostalAddress>
  /**
   * The telephone number of the organization.
   */
  telephone?: string
  /**
   * The email address of the organization.
   */
  email?: string
  /**
   * The date the organization was founded.
   */
  foundingDate?: string
}
```

## [Related Schemas](#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 add MusicRecording structured data. Display song info with artist, album, and duration in search results.](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)
- [Required properties](#required-properties)
- [Recommended Properties](#recommended-properties)
- [Examples](#examples)
- [Defaults](#defaults)
- [Resolves](#resolves)
- [Types](#types)
- [Related Schemas](#related-schemas)

[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/typescript/head/guides/get-started/overview)
- [useHead](https://unhead.unjs.io/docs/typescript/head/api/composables/use-head)
- [useSeoMeta](https://unhead.unjs.io/docs/typescript/head/api/composables/use-seo-meta)
- [useHeadSafe](https://unhead.unjs.io/docs/typescript/head/api/composables/use-head-safe)
- [useScript](https://unhead.unjs.io/docs/typescript/head/api/composables/use-script)

### Schema.org

- [Getting Started](https://unhead.unjs.io/docs/typescript/schema-org/guides/get-started/overview)
- [useSchemaOrg](https://unhead.unjs.io/docs/typescript/schema-org/api/composables/use-schema-org)
- [Nodes](https://unhead.unjs.io/docs/typescript/schema-org/guides/core-concepts/nodes)
- [Recipes](https://unhead.unjs.io/docs/typescript/schema-org/guides/recipes/identity)

### Guides

- [Titles](https://unhead.unjs.io/docs/typescript/head/guides/core-concepts/titles)
- [Streaming SSR](https://unhead.unjs.io/docs/typescript/head/guides/core-concepts/streaming)
- [DOM Events](https://unhead.unjs.io/docs/typescript/head/guides/core-concepts/dom-event-handling)
- [Plugins](https://unhead.unjs.io/docs/typescript/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 <head> 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)