Suede Audit Run your free audit
All checks

Check reference

Tell machines who is behind the page.

The Entity evidence pillar is three checks on the homepage's JSON-LD. Two of them are high severity, and a page with no structured data fails all three, losing 13 of the 90 points at once. The scanner reads every <script type="application/ld+json"> block in the served HTML, parses it as JSON, and walks every node, including nested objects and @graph arrays, to collect @type and sameAs values.

Valid JSON-LD is present

EntityHigh severity5 of 90 pointsid: schema

Repair shown in the report: Add valid JSON-LD for the organization and the page subject.

The rule. Passes when at least one JSON-LD block parses as JSON. The observed value reads, for example, "1 valid of 2 blocks", so a broken block shows even when another passes. Trailing commas, comments and unescaped quotes all break parsing.

Why it matters. Google marks JSON-LD as its recommended format and accepts any supported format as long as the markup is valid (Google, intro to structured data). Google can read JSON-LD injected by JavaScript, but the scanner reads the served HTML, and Google's own JavaScript guidance notes that not all bots can run JavaScript (Google, JavaScript SEO basics).

How to fix it. Render the block in the server response and run it through a JSON parser before you ship. One valid block that describes the organization and the page is enough to pass.

A primary entity type is declared

EntityHigh severity5 of 90 pointsid: entity-type

Repair shown in the report: Declare the primary Organization, Person, or business entity in JSON-LD.

The rule. Passes when any parsed node has an @type of exactly Organization, Corporation, LocalBusiness, OnlineBusiness or Person. Matching is exact and case-sensitive. A more specific type on its own, such as NGO or Restaurant, does not count, and neither does a prefixed form such as schema:Organization.

Why it matters. Google says Organization markup on your home page can help it understand your administrative details and disambiguate your organization in search results, including which logo it shows (Google, organization structured data). Schema.org lists Corporation, LocalBusiness and OnlineBusiness among the more specific types of Organization (schema.org/Organization).

How to fix it. Declare the entity that owns the site on the homepage. JSON-LD lets one node carry several types, so a nonprofit can write "@type": ["Organization", "NGO"] and keep its specific type (JSON-LD 1.1).

Entity identity links are declared

EntityMedium severity3 of 90 pointsid: same-as

Repair shown in the report: Add verified public identity URLs through sameAs on the primary entity.

The rule. Passes when any parsed node has a non-empty sameAs: a URL string, or an array with at least one entry. The scanner records that the links exist; it does not fetch them.

Why it matters. Schema.org defines sameAs as the "URL of a reference Web page that unambiguously indicates the item's identity", such as a Wikipedia page, a Wikidata entry or an official website (schema.org/sameAs). Google's organization documentation describes it as a page on another site with more information about your organization, such as a social or review profile, and accepts several URLs.

How to fix it. Add sameAs to the primary entity node with profiles you control. Mark up only what the page shows: Google's guidelines say not to mark up content that is hidden from readers, irrelevant or misleading (Google, general structured data guidelines).

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Example Co",
  "url": "https://www.example.com/",
  "logo": "https://www.example.com/logo.png",
  "sameAs": ["https://profiles.example.net/example-co"]
}

More check references

Related Suede guides

Every rule on this page is read from the scoring code in lib/engine.mjs. If the code changes, this reference changes with it.

Contact