Overview
During a review of the site's metadata, we identified that OpenGraph support is only partially implemented. Several critical tags are missing, and the existing social share image (opentdf-social.png) does not reflect the new brand design introduced in the homepage redesign.
This issue tracks the work to fully implement OpenGraph, add Twitter/X Card support, and replace the social image.
Current state
Docusaurus themeConfig.image is set to img/opentdf-social.png, which provides a global og:image fallback. The homepage has explicit og:title and og:description tags. Everything else is missing or incomplete.
Tasks
High priority
Medium priority
Design
Minor
Acceptance criteria
- Pasting any opentdf.io URL into the LinkedIn post inspector, Twitter Card Validator, or Facebook Sharing Debugger returns a correctly populated preview with the new brand social image
og:title, og:description, og:image, og:url, og:type, and og:site_name are all present on the homepage
- Twitter/X Card tags are present and valid
- Social image visually matches the new site design
🤖 Generated with Claude Code
Overview
During a review of the site's metadata, we identified that OpenGraph support is only partially implemented. Several critical tags are missing, and the existing social share image (
opentdf-social.png) does not reflect the new brand design introduced in the homepage redesign.This issue tracks the work to fully implement OpenGraph, add Twitter/X Card support, and replace the social image.
Current state
Docusaurus
themeConfig.imageis set toimg/opentdf-social.png, which provides a globalog:imagefallback. The homepage has explicitog:titleandog:descriptiontags. Everything else is missing or incomplete.Tasks
High priority
og:urlto the homepage (https://opentdf.io)og:type: "website"to the homepageog:imageexplicitly to the homepage (do not rely solely on the global fallback)og:image:widthandog:image:height(standard: 1200×630)twitter:card,twitter:title,twitter:description,twitter:imageMedium priority
og:site_name: "OpenTDF"globally indocusaurus.config.tsog:image:width/og:image:heightto the globalheadTagsDesign
opentdf-social.png(1200×630px) that reflects the new brand: dark background (#0a0c10), new OpenTDF icon, headline in cyan-to-purple gradient treatment,opentdf.ioURLMinor
logoURL currently points tohttps://docs.opentdf.io/img/opentdf-social.pngbut the orgurlishttps://opentdf.io— update the logo URL to match once the new social image is in placeAcceptance criteria
og:title,og:description,og:image,og:url,og:type, andog:site_nameare all present on the homepage🤖 Generated with Claude Code