Skip to content

[WEB-9189] Add TechArticle JSON-LD structured data to docs pages#37407

Open
Jackie-Robson wants to merge 1 commit into
masterfrom
jackie.robson/web-9189-json-ld-schema
Open

[WEB-9189] Add TechArticle JSON-LD structured data to docs pages#37407
Jackie-Robson wants to merge 1 commit into
masterfrom
jackie.robson/web-9189-json-ld-schema

Conversation

@Jackie-Robson

Copy link
Copy Markdown
Contributor

What does this PR do? What is the motivation?

Fixes WEB-9189

Adds a TechArticle JSON-LD structured data block to every leaf page on docs.datadoghq.com. This gives search engines and AI inference systems a machine-readable signal connecting docs content to Datadog as its publisher.

Changes:

  • New partial layouts/partials/structured-data.html — emits a TechArticle JSON-LD block using existing Hugo frontmatter fields (title, description, lastmod, word count). No new frontmatter required.
  • layouts/_default/baseof.html — includes the partial in <head>, gated on .IsPage && .File so it only fires on leaf pages, not section/list pages.

The publisher and author fields reference https://www.datadoghq.com/#organization, the canonical Organization node already defined on the marketing site.

Merge instructions

Merge readiness:

  • Ready for merge

Additional notes

Validate after deploy using https://validator.schema.org against a sample of docs pages.

Adds a new Hugo partial (layouts/partials/structured-data.html) that
emits a TechArticle JSON-LD block on every leaf page. The block sets
publisher and author to the canonical Organization node on
datadoghq.com, and populates name, headline, description, url,
inLanguage, dateModified, and wordCount from existing Hugo context —
no frontmatter changes required.

Resolves WEB-9189
@Jackie-Robson Jackie-Robson requested a review from a team as a code owner June 10, 2026 13:03
@github-actions github-actions Bot added the Architecture Everything related to the Doc backend label Jun 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Architecture Everything related to the Doc backend

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant