Skip to content

Add Organization/WebSite structured data + real OG images - #7

Merged
tishachawla-jg merged 1 commit into
mainfrom
site/seo-structured-data-og-images
Aug 12, 2026
Merged

Add Organization/WebSite structured data + real OG images#7
tishachawla-jg merged 1 commit into
mainfrom
site/seo-structured-data-og-images

Conversation

@tishachawla-jg

Copy link
Copy Markdown
Contributor

Summary

  • index.html: added Organization + WebSite JSON-LD (name, logo, founders as Person entities, sameAs linking GitHub org + both LinkedIns). This is the concrete gap from earlier: the site had zero structured data anywhere except the one blog post's BlogPosting schema. This is what lets Google show a real Knowledge Panel / sitelinks for "AgentPlane" searches instead of a bare blue link.
  • projects.html / about.html / media.html / blog.html: replaced the generic logo-mark.png (a 400x400 square icon that gets badly cropped in link previews) with a real 1200x630 branded OG card per page, matching that page's actual headline and subtext. Also added the missing twitter:image tag on all four (previously present as og:image only) and switched twitter:card from summary to summary_large_image, without that, Twitter/X renders a small thumbnail instead of the big card even when an image is present.

How the cards were made

Built as SVG using the site's existing dot-grid + accent-glow hero styling for visual consistency, then rendered to PNG via headless Edge (same pipeline as the blog-post diagram PNGs in #6). SVG sources aren't committed, these are one-off generated assets, not meant to be hand-edited like the blog's own diagrams.

Test plan

  • Validated both JSON-LD blocks parse as valid JSON.
  • Confirmed no page still references logo-mark.png as og:image.
  • Visual review of all four OG cards (1200x630, nothing clipped, matches each page's real copy).

🤖 Generated with Claude Code

- index.html: Organization + WebSite JSON-LD (name, logo, founders, sameAs
  linking GitHub/LinkedIn). This is what lets Google show a proper
  Knowledge Panel / sitelinks box for "AgentPlane" searches instead of a
  bare blue link; the site had zero structured data outside the one blog
  post that already had BlogPosting schema.
- projects.html, about.html, media.html, blog.html: replaced the generic
  logo-mark.png og:image (a 400x400 square icon, cropped badly in link
  previews) with a real 1200x630 branded card per page, matching each
  page's actual headline/subtext. Also added the missing twitter:image tag
  and switched twitter:card from "summary" to "summary_large_image" so
  Twitter/X actually renders the big card instead of a small thumbnail.
- Cards built as SVG (site's existing dot-grid/accent-glow hero style),
  rendered to PNG via headless Edge, same pipeline as the blog diagram PNGs
  in the dev.to PR. SVG sources not committed, one-off generated assets,
  not meant to be hand-edited like the blog's diagrams.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@tishachawla-jg
tishachawla-jg merged commit ad23804 into main Aug 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant