Unhead
Nuxt
Schema

Organization Schema - JSON-LD Guide & Examples

Copy for LLMs
On this page

Organization structured data 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 to build your structured data visually.

Schema.org Organization

  • Type: defineOrganization<T extends Record<string, any>>(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

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 NodeRelations<ImageObject | string>
    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.

Google also documents alternateName, contactPoint, description, organization identifiers, return policies, membership programs, shipping services, employee counts, and interaction statistics. These fields and their nested node types are available in Unhead.

MemberProgram requires name, description, and at least one hasTiers entry. Each MemberProgramTier requires name and hasTierBenefit.

ShippingService requires shippingConditions. Its typed fields cover fulfillment, handling and transit periods, destinations, origins, order and package constraints, seasonal overrides, rates, and member tiers.

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 for full context.

  • address as PostalAddress object
  • contactPoint, hasMemberProgram, hasMerchantReturnPolicy, hasShippingService, and numberOfEmployees as typed nested nodes
  • 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, referenced by the primary Organization identity.

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@id": "https://nuxtjs.org/#identity",
      "@type": "Organization",
      "logo": {
        "@id": "https://nuxtjs.org/#logo"
      },
      "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"
    }
  ]
}

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?: NodeRelations<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 a 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
  alternateName?: string
  contactPoint?: NodeRelations<ContactPoint>
  description?: string
  duns?: string
  globalLocationNumber?: string
  hasMerchantReturnPolicy?: NodeRelations<MerchantReturnPolicy>
  hasMemberProgram?: NodeRelations<MemberProgram>
  hasShippingService?: NodeRelations<ShippingService>
  iso6523Code?: string
  legalName?: string
  leiCode?: string
  naics?: string
  numberOfEmployees?: NodeRelation<QuantitativeValue>
  taxID?: string
  vatID?: string
  identifier?: NodeRelations<PropertyValue | string>
  agentInteractionStatistic?: NodeRelations<InteractionCounter>
  interactionStatistic?: NodeRelations<InteractionCounter>
}

export interface Organization extends OrganizationSimple {}

Related Schemas

Edit this page
Markdown For LLMs
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.

Person Schema

Use definePerson() to add Person structured data. Establish author identity for articles and content with name, image, and social profile links.