---
title: "Organization Schema - JSON-LD Guide & Examples"
description: "Add Organization structured data with Unhead. JSON-LD examples for company identity, logo, sameAs social profiles, and Google Knowledge Panel setup."
canonical_url: "https://unhead.unjs.io/docs/schema-org/api/schema/organization"
last_updated: "2026-05-07T16:40:35.957Z"
---

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
{
  "@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.

<tip icon="i-heroicons-wrench-screwdriver">

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

</tip>

## Schema.org Organization

- **Type**: `defineOrganization(input?: Organization)`<br />

Describes an organization (a company, business or institution). Most commonly used to identify the publisher of a WebSite.

## Useful Links

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

## Required properties

- **name** `string`<br />

The name of the business.

## Recommended Properties

- **logo** `SingleImageInput`<br />

Logo image url, can be relative to your site root.
- **sameAs**  `string[]`<br />

An array of URLs that also belong to the Organization
- **telephone** `string`<br />

The telephone number of the organization.
- **email** `string`<br />

The email address of the organization.
- **foundingDate** `string`<br />

The date the organization was founded.

## Examples

### Minimal

```ts
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](/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:

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

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

```json
{
  "@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

```ts
/**
 * 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

- [Person](/docs/schema-org/api/schema/person) - Organization members
- [LocalBusiness](/docs/schema-org/api/schema/local-business) - Physical locations