squirrelscan
GitHub

Organization schema: name, url, logo and sameAs checks

Organization JSON-LD missing name or url, with no logo, or a sameAs list that omits a social profile the site clearly runs. squirrel finds all three.

What Organization schema is

Organization is the schema.org type for the company, institution or group behind a site. It states the identity fields as named properties: name, url, logo, contactPoint, and sameAs, an array of URLs for the same entity elsewhere, such as a LinkedIn company page or a Wikipedia article.

Google’s guidance is to put the node on the page that best describes the organization, typically the homepage or an about page. A business with a physical location or a service area uses LocalBusiness instead, which is a subtype of Organization and carries the address and hours fields as well.

What squirrel checks

The rule reads every script[type="application/ld+json"] on the page and keeps the first Organization or Corporation node from the last script that contains one, matching either a plain @type or an @type array. It then emits between one and four checks:

  • organization-schema: reports at info status with the message No Organization schema found when no such node exists. No further checks run.
  • organization-required: warns with the message Organization schema missing required properties and lists the missing names as items. The required set is name and url. When both are present it passes with Organization schema has required properties.
  • organization-logo: emitted only when logo is absent, at info status, with the message Organization missing logo and the value Add logo for knowledge panel.
  • organization-social: passes with the message N social profile(s) linked, counting the string entries in sameAs. With no string entries it reports at info status with No sameAs social profiles and the value Link to social profiles for brand verification.
  • organization-sameas-missing: emitted only when the site profile already knows official social accounts for the site and sameAs omits one or more of them. It warns with the message N known social account(s) missing from schema sameAs, the value Add detected official profiles to Organization sameAs, and one item per account labelled with its platform.

logo is not part of the required set even though the missing-logo result mentions the knowledge panel. A page with name and url and no logo passes organization-required and gets the separate info result. Every property test is a truthiness test rather than a presence test, so a property present but empty, 0 or false counts as missing. The cross-check in the last bullet is a no-op when the audit has no site metadata, so an offline run behaves as if it were not there.

How to fix it

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Acme Coffee",
  "url": "https://example.com/",
  "logo": "https://example.com/logo.png",
  "sameAs": [
    "https://www.linkedin.com/company/acme-coffee",
    "https://github.com/acme-coffee"
  ]
}
</script>

Put it in the <head> of the homepage, and list every profile you control in sameAs.

JSON-LD wrapped in an @graph array, which is what Yoast, Rank Math and several other generators emit, is read the same as a top-level node: the rule flattens each script before looking for Organization or Corporation.

Rule IDschema/organization
CategoryStructured Data
ScopePer-page
Severityinfo
Weight4/10

Enable / disable

Disable this rule

[rules]
disable = ["schema/organization"]

Disable all Structured Data rules

[rules]
disable = ["schema/*"]

Enable only this rule

[rules]
enable = ["schema/organization"]

enable replaces the default ["*"], so this is the only rule selected. Leave disable out: a rule that matches any disable pattern is skipped even when enable names it. Only an enabled setting under a rule’s own [rule_options] table overrides both lists.

Structured data findings ship in every audit next to the core SEO, performance and agent experience rules. See Fix SEO issues with AI for how an agent works through a report.

References

Check your site

Run squirrel audit https://example.com and open the Structured Data section of the report. Missing properties and missing profiles are listed by name. Signed-out local audits need no account and cost nothing. Signed-in audits spend credits.

Type to search…

↑↓ navigate↵ openesc close