Skip to content

Blog OG meta tags + tiered branded share cards #71

@taha-abbasi

Description

@taha-abbasi

Problem

When sharing blog URLs (e.g. sallys-spa.tryscribe.co), the OG image falls back to the generic Scribe platform card. This is the most-shared surface we have — every share is either a missed branding opportunity or free Scribe advertising (depending on tier).

Solution: Tiered Dynamic OG Cards

Server-side generated OG cards using a consistent template structure, parameterized per brand.

Template Design ("Best of Both")

  • Same layout/structure across all brands → builds Scribe brand recognition
  • Parameterized with: brand name, niche color palette, niche icon/visual element, article title
  • Each brand feels unique but recognizably "a Scribe blog"

Tier Behavior

Tier Brand Presence Scribe Presence
Free Brand name + niche styling Prominent — "Powered by Scribe" + Scribe logo. Every share = free advertising
Pro Brand dominant, brand colors Subtle — "Built with Scribe" footer, smaller placement
Scale Full brand control None — complete white-label

OG Tags Per Page Type

Page og:title og:image og:description
Blog homepage "{Brand Name} Blog" Branded card (tiered) Brand-level description
Individual article Article title Article-specific card (title on card + brand) Article meta description

Implementation Notes

  • NOT Vercel-dependent — must work on any hosting platform (self-hosted, AWS, etc.)
  • Options: sharp/canvas-based server-side image generation, or pre-rendered SVG → PNG
  • Brand data already in MongoDB: brandName, niche, location, tone
  • Card dimensions: 1200x630 (standard OG)
  • Cache generated cards (don't regenerate on every request)

Design Considerations

  • Tasteful, elegant — not cheap "made with" badges
  • Free tier should make Scribe look premium (reflects well on us AND the brand)
  • Referral/sharing incentivization will be built on top of this later
  • Different articles should produce visually distinct cards (article title on card)

Related

  • 🔗 Custom domain connection #7 Custom domain connection — when implemented, OG tags must reference the custom domain, not .tryscribe.co
  • Referral system (future) — share cards are the primary viral surface

Priority

Medium-high — directly impacts virality and brand perception. Should be done before public launch.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestscribe-launchScribe Launch project board

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions