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.
  • hasMerchantReturnPolicy: An array of the type MerchantReturnPolicy which represents a return policy of 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',
		'sameAs' => 'https://en.wikipedia.org/wiki/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.