How does social sharing and Open Graph work in VeloCMS?

VeloCMS generates Open Graph (og:) and Twitter Card meta tags automatically for every published post using your post's title, excerpt, featured image, and author data — you don't need to configure anything for basic social sharing to work. When someone shares your link on LinkedIn, Twitter/X, Slack, or Facebook, the platform reads these tags and renders a rich preview card with your image and headline.

Which Open Graph tags does VeloCMS generate?

Every post page includes og:title (your post title), og:description (your meta description or excerpt), og:url (the canonical URL), og:type (set to 'article'), og:image (your featured image), og:image:width and og:image:height, og:article:published_time, og:article:modified_time, og:article:author, and og:site_name. For Twitter/X specifically, VeloCMS also outputs twitter:card (summary_large_image when a featured image exists, summary when it doesn't), twitter:title, twitter:description, and twitter:image.

What image does VeloCMS use for the social preview card?

VeloCMS uses your post's featured image as the og:image. If your post doesn't have a featured image, VeloCMS falls back to the site-level Open Graph image configured in Admin → Settings → SEO & Social. If neither exists, the og:image tag is omitted — most social platforms then show a link preview with just the title and description, no image. For best results on Twitter/X the og:image should be at least 1200 × 630 pixels at 2:1 aspect ratio. VeloCMS's Cloudflare R2 image pipeline resizes images on request, so even if you upload a portrait or square image it will be cropped to the correct OG dimensions when social crawlers request it.

Can I override the social title or image for a specific post?

Yes. Open the post in the editor, click the SEO panel (the compass icon on the right sidebar), and look for the Social section near the bottom. You'll see separate fields for the social headline and the social description, which override the og:title and og:description without changing your actual post title or meta description. You can also select a different image specifically for social previews — useful when your featured image is portrait-oriented and looks awkward in the wide 1200×630 OG crop. These social-specific overrides are stored alongside the post and don't affect SEO metadata.

Why does Facebook or LinkedIn still show the old image after I updated it?

Social platforms aggressively cache Open Graph data. If you update a post's featured image or title, the new og:image or og:title won't appear in shares until the platform's cache expires (typically 24–48 hours) or you force a re-scrape. Facebook has a Sharing Debugger at developers.facebook.com/tools/debug that lets you paste your URL and force a cache refresh. LinkedIn has a similar Post Inspector at linkedin.com/post-inspector. Twitter/X refreshes cards more quickly — usually within a few hours — but doesn't offer a manual flush tool. If urgency matters, the fastest approach is changing the post's slug (which creates a new URL that the platforms haven't cached yet) and setting up a redirect from the old slug.