Skip to content

Compatibility notes

Metrics

  • Windowed search metrics can be attached to pages as well as queries. The domains of the windowed Search Console metrics (clicks7Days, clicks28Days, clicks3Months, clicks6Months, the matching impressions*, ctr* and averagePosition* properties, and their trend properties) were widened from Query to Query ∪ WebPage. Existing query-level data remains valid; no migration is needed.
  • A 6-month window was added: clicks6Months, impressions6Months, ctr6Months and averagePosition6Months.
  • averagePositon7Days is deprecated because its IRI is misspelled. Use averagePosition7Days. The old IRI is kept so existing data stays valid.
  • hasLinkGroup from WebPage to LinkGroup, followed by hasLink from LinkGroup to Link, is the canonical pattern for grouped links. The direct link property remains for ungrouped or raw extracted links.
  • isLinkOf points from Link back to LinkGroup, as the inverse of hasLink. Data that used isLinkOf to point from a Link directly to a WebPage should use link for ungrouped links, or add a LinkGroup and connect the page with hasLinkGroup.
  • linkGroupType complements linkGroupName. The name is free-text display; the type (header, footer, body, sidebar, navigation) is the value consumers can filter on.
  • Links state their destination (0.1.0). linkTargetUrl holds the href as a string and should be set on every Link. linkTarget points to the resolved destination node (a WebPage, a URL node or an entity) once there is one. linkRel holds one rel token per value.
  • linkText widened from xsd:string to rdfs:Literal, so anchors can carry a language tag. Existing values stay valid.
  • linkLocation and linkGroupType share one enumeration: header, footer, body, sidebar, navigation. Data that used nav for linkLocation should use navigation. When a LinkGroup exists, its linkGroupType takes precedence over linkLocation.
  • These terms are deprecated. Their IRIs stay resolvable and existing data stays valid:
Deprecated Use instead
anchorResource linkTarget
linkgroupID linkGroupID, typed xsd:string rather than xsd:int
noFollow linkRel with the value nofollow
linkType Nothing. Derive internal versus external from Domain: compare the source and target pages' hasDomain, or the linkTargetUrl host with the source page's domainName.
AnchorText (class) linkText on the Link. anchorValue and influencedByQuery are unchanged for now.

Other

  • evaluationID uses xsd:string, so identifiers such as eval_1745567328195 are valid.
  • Page-level quality properties such as seoScore and readabilityGradeLevel are kept. New integrations should link a WebPage or Chunk to a QualityScore instead.
  • Query clusters use hasClusterQuery / isClusterQueryOf. hasQuery / isQueryOf stay scoped to WebPage and Query.
  • PageGroup stays scoped to A/B-testing cohorts. Use PageType for functional classifications; nothing infers one from the other.
  • Structured-data profile applicability, selection, generation and validated conformance are separate states. A profile being applicable does not authorize generation or guarantee search-engine eligibility.