Organization entity in WordPress
← One organization, described the same way everywhere
Most WordPress sites already emit an Organization or Person node from their SEO plugin. The job is usually to fix and complete that node, not to add a second one.
Yoast SEO
Settings, Site representation (Search appearance, General): choose Organization or Person,
set the name, upload a logo, and fill the social profile fields. Yoast outputs an
Organization node with a stable @id of the form https://example.com/#organization and
links WebSite and WebPage nodes to it. Extra profile URLs beyond the built-in fields can
be added in its “Other social profiles” area. To add properties it does not expose (for
example a Wikidata sameAs), extend its graph with the wpseo_schema_organization filter
instead of printing a second script block.
Rank Math
Titles and Meta, Local SEO: set Person or Company, name, logo, URLs. Rank Math emits an
Organization node too; extend it with the rank_math/json_ld filter.
Rules of thumb
- Exactly one active plugin should emit Organization. If a theme, a “schema” plugin or a
page builder also emits one, disable its organization output; two nodes with different
@idorurlis what failsaeo.entity-identity-consistent. - Extend rather than replace when the plugin’s node is correct but incomplete. Replace only
when the plugin cannot be configured to the right
name/url/type; then disable its organization output and publish your own node, keeping the same@idpattern. - The plugin’s site name and logo settings feed the node. Fix them there; hand-editing theme files is overwritten on the next update.
- Multisite or several domains: set the same legal name and the apex
urlon each, and confirm each site does not mint its own@idfrom its own domain. - Verify what is actually served (view-source, or the validator), because caching and optimisation plugins sometimes serve stale markup.
Filter sketch (put in a small must-use plugin or child theme, not the parent theme):
add_filter('wpseo_schema_organization', function ($data) { $data['sameAs'][] = 'https://www.wikidata.org/wiki/Q0000000'; // only if the item is real return $data;});AEO Toolkit is an open-source instrument by Advance Labs.