Skip to main content

Schema piece - Organization

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

May be transformed into a more specific type (such as Corporation or LocalBusiness ) if the required conditions are met.

Triggers

Should be output on all public pages.

Required properties

A valid Organization must have the following properties.

  • @type: Organization.
  • @id: The site's home URL appended by #/schema/Organization/{{ID}}, where {{ID}} is a unique identifier.
    • If the organization is the publisher of the WebSite (i.e., the "primary organization", or "this organization"), then the value of {{ID}} should be 1.
    • name: The name of the Organization.
  • URL: The site's home URL.
  • logo: A reference-by-ID to an ImageObject of the organization's logo.

Failure scenarios

If any of the required fields are missing or invalid, the node should not be output.

If the node is not output, any entities which would otherwise have declared a relationship with the Organization (e.g., as the publisher of a WebSite, or the manufacturer of a Product) should remove those references.

Optional properties

The following should be added whenever available and valid:

  • sameAs: An array of URLs representing declared social/authoritative profiles of the organization (e.g., a Wikipedia page, or Facebook profile).
  • image: An array of references-by-ID to ImageObject nodes which represent the organization (including the logo ).
  • alternateName: An alternate (usually shorter) name for the organization.

Transformations

The Organization type may be transformed in the following scenarios.

When the business is 'local'

  • When location information is available, the Organization may be eligible for extension into a LocalBusiness type.

Examples

Minimum criteria

{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Organization",
"@id": "https://www.example.com/#/schema/Organization/abc123",
"url": "https://www.example.com/",
"logo": {
"@id": "https://www.example.com/uploads/example-image.jpg"
},
"name": "Example organization name"
}
]
}

Extended criteria

{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Organization",
"@id": "https://www.example.com/#/schema/Organization/abc123",
"url": "https://www.example.com/",
"name": "Example organization name",
"alternateName": "Short org name",
"sameAs": [
"https://www.wikipedia.com/example-organization",
"https://www.linkedin.com/company/1234"
],
"logo": {
"@id": "https://www.example.com/uploads/example-image.jpg"
},
"image": [
{
"@id": "https://www.example.com/uploads/example-image.jpg"
},
{
"@id": "https://www.example.com/uploads/example-image-2.jpg"
}
]
}
]
}

WordPress API: Change Organization Schema output

To make changes to the Organization schema that Yoast SEO outputs, you can use our wpseo_schema_organization filter. Here is an example:

add_filter( 'wpseo_schema_organization', 'change_organization_schema', 11, 2 );

/**
* Add extra properties to the Yoast SEO Organization
*
* @param array $data The Schema Organization data.
* @param Meta_Tags_Context $context Context value object.
*
* @return array $data The Schema Organization data.
*/
function change_organization_schema( $data, $context ) {
$data['@type'] = [
'Organization',
'Brand',
];
$data['founder'] = [
'@type' => 'Person',
'name' => 'Joost de Valk',
'url' => 'https://yoast.com/about-us/team/joost-de-valk/',
'sameAs' => 'https://yoast.com/about-us/team/joost-de-valk/',
];
$data['foundingDate'] = '2010-05-01';
$data['numberOfEmployees'] = (int) wp_count_posts( 'yoast_employees' )->publish;
$data['slogan'] = 'SEO for Everyone';
$data['description'] = 'Yoast helps you with your website optimization, whether it be through our widely used SEO software or our online SEO courses: we're here to help.';
$data['url'] = 'https://yoast.com/';
$data['legalName'] = 'Yoast BV';
$data['alternateName'] = 'Yoast';
$data['parentOrganization'] = [
'@type' => 'Organization',
'name' => 'Newfold Digital',
'description' => 'Newfold Digital is a leading web presence solutions provider serving millions of small-to-medium businesses globally.',
'url' => 'https://newfold.com/',
'sameAs' => [
'https://newfold.com/',
],
'logo' => 'https://yoast.com/app/uploads/2022/01/newfold-logo.png',
];
$data['memberOf'] = [
'@type' => 'Organization',
'name' => 'World Wide Web Consortium (W3C)',
'description' => 'The World Wide Web Consortium (W3C) is an international community that develops open standards to ensure the long-term growth of the Web.',
'url' => 'https://w3.org/',
'sameAs' => [
'https://w3.org/',
],
'logo' => 'https://www.w3.org/Icons/w3c_main.png',
];

return $data;
}

To make more changes to our Schema output, see the Yoast SEO Schema API.