Structured Data And Social Meta Tags
P2 priorityp2-is-structured-data-and-social-meta-tagsNo JSON-LD; Open Graph and Twitter tags thin
- Stage
- 01-to-do
- Author
- Ivan Hawkes
- Created
No structured data, and thin social meta tags.
Current State
Measured over public/ of the current build.
be-best/layouts/_partials/meta/meta.html writes a canonical link, a
description, og:title, og:description, og:url, og:type, twitter:card,
twitter:title and twitter:description, plus og:image, twitter:image and
twitter:site when the params behind them are set. The gaps:
- Structured data is absent: no page carries an
application/ld+jsonblock, so the structured data audit scores 0/100 and no page is eligible for rich results. og:imageandtwitter:imageare written only when.Site.Params.socialImageis set, andconfig/_default/params.yamlsets nosocialImage, so a shared link carries no image.twitter:siteemits@ivanhawkes, read fromsocial.twitter, added on 2026-10-29.og:typeis hard-coded towebsiteon every page, so posts and recipes carry no article properties (article:published_time,article:author,article:section).- There is no
robots,author,publisher,creatororkeywordsmeta tag, which is what holds the meta tags score at 74/100. sitemap.xmland oneindex.xmlfeed are already generated, and the head links the feed: the crawl route exists, the descriptions of the pages do not.
Work
- Params - define
socialImageinconfig/_default/params.yaml, and add the share image tostatic/through Git LFS: 1200x630 suitstwitter:cardsummary_large_image. - Types - select
og:typeby content type:articleforpostpages,websitefor the home page and section pages, and the matching properties (published, modified, author, section) on articles. - JSON-LD - a head partial emitting, per page:
WebSiteon the home page,BlogPostingon a post (authorPerson, publisher, image,datePublishedanddateModified),Recipeontype: recipereading theingredients.yamlsidecar and theprep-time/cook-timeISO durations,BreadcrumbListon every page below the home page, andAboutPagefor theabout/pages. - Meta tags - add
robots,author,publisher,creatorandkeywords(from the pagetags), and state the indexing decision for the working sections:kanbanandspecificationare working documents, so say whether they are indexed ornoindex.
Acceptance Criteria
- Every page carries a JSON-LD block of the type above, and the blocks validate against Google’s Rich Results Test with no errors; the warnings are listed on this card
-
og:imageandtwitter:imagecarry a real image on the home page and on a post, and a shared link shows it - A post page reports
og:typearticlewith published and modified times, an author and a publisher - The
robots,author,publisher,creatorandkeywordstags are present, and the indexing decision forkanbanandspecificationis visible in the built pages - The re-run review reports the structured data and meta tags scores, recorded on this card