Originally published on headlark.com .

Structured data tells search engines what a page is: an article with an author and a date, a position in a breadcrumb trail, the organization behind the site. Google reads it to show rich results, such as breadcrumbs instead of a bare URL or an article's date and image, and recommends JSON-LD as the format ( Google Search Central: structured data ). It's a <script type="application/ld+json"> block in the page's HTML, so on a static site it belongs in the build output.

Which types fit a docs site or blog

Page Type What it can give you

Blog post, changelog entry BlogPosting or Article Headline, date, image and author understood correctly ( Article )

Any page below the home page BreadcrumbList A breadcrumb trail in desktop results ( Breadcrumb )

Home page Organization , WebSite Your logo and the site name shown in results

Product or tool page SoftwareApplication Price and rating details, if the page shows them

Skip FAQPage and HowTo for rich results: Google no…