Start with relationships, not markup volume

Structured data is useful when it expresses relationships already established on the page: an organization has a founder, offers a service, publishes an article and uses a preferred website identity. Adding more types does not compensate for missing or contradictory visible information.

Entity map

A small service-business graph

Organization → founder → Person
Organization → makesOffer / provider → Service
Article → author → Person
WebSite → publisher → Organization

Choose the page's main entity

The home page normally anchors the organization and website. A service page should describe a real service available from that provider. An article should identify its headline, author, publication dates and publisher. A profile page can connect a real person to credentials and areas of work that are also visible.

Values that require restraint

PropertySafe ruleCommon failure
name / alternateNameUse the public names consistently used on the site.Adding keyword-rich aliases nobody uses.
sameAsLink profiles that represent the same entity.Linking clients, partners or unrelated directories.
areaServedReflect a real service boundary.Listing every country to imply global presence.
review / ratingUse only eligible, visible and genuine review information.Inventing an aggregate or marking up third-party ratings incorrectly.
founder / employeeName real people whose relationship is public.Creating people or credentials only inside JSON-LD.

Implementation order

  1. Write the visible identity and service facts first.
  2. Assign stable @id values to the organization, website and public people.
  3. Reference those identifiers instead of creating duplicate disconnected objects.
  4. Add only properties the team can maintain.
  5. Validate syntax with Schema Markup Validator and feature eligibility with Google's Rich Results Test.
  6. Compare the rendered page and markup after every template change.

Schema is not a private fact channel

Do not hide legal names, service claims, prices, reviews or FAQs only in markup. Google states that structured data should describe the page and should not refer to content hidden from users. A smaller graph that matches the page is more trustworthy than a large graph full of unsupported values.

Maintenance test

Quarterly, crawl the site's JSON-LD and compare organization names, URLs, dates and profile links. Re-test representative templates after redesigns. Record warnings separately from errors: not every optional recommendation justifies a site change.

An approval checklist for entity changes

Before publishing a new organization, person or service value, identify its visible source, factual owner and update path. Confirm that the canonical page uses the same name, that the relationship is current and that no existing node creates a contradiction. Legal names, addresses, credentials and commercial availability should be reviewed by the person responsible for those facts—not inferred from an old directory or inserted only because a property exists in Schema.org.

Primary references

Where to go next

Use the Nexus AI Visibility Framework to place this topic inside a complete measurement system, or review the AI Visibility Audit scope.

Changelog

13 Jul 2026 — Expanded with an independent structure, examples, implementation guidance and primary references.