Open Graph

Open Graph tags make your pages render nicely when someone shares them on Facebook, X, LinkedIn, Slack, and similar services. Chinaski writes all the Open Graph and matching Twitter (X) tags for you when it builds your site.

What Chinaski tags automatically

Every page and post in the static output carries:

• og:title: your OG title, falling back to your meta title, then the page title
• og:description: your OG description, falling back to your meta description, then the site tagline
• og:image: your OG image URL, falling back to the featured image, then the default share image
• og:type: article for blog posts, website for everything else (pages, the homepage, and listing pages)
• og:locale: the page’s language code (e.g. en)
• og:url and og:site_name, only when there is a canonical URL and the site has a name

Tags with no value are left out entirely; nothing emits empty. The equivalent Twitter tags (title, description, image) are emitted alongside, using a large-image card when there’s a share image and a summary card otherwise, and twitter:site is set from the X/Twitter handle on the Integrations settings tab.

Setting OG fields per page or post

The editor for each page and post has three fields: OG Title, OG Description, and OG Image URL.

• Leave OG Title blank to inherit the Meta Title (or the page/post title).
• Leave OG Description blank to inherit the Meta Description.
• OG Image URL accepts any image URL.

Everything takes effect after the next site build.

Caching a fallback image: default share image

Instead of setting an OG image on every item, choose one site-wide fallback under Settings → General: the Default Site Image setting. It’s used as the share image on any page or post with no OG image and no featured image. Leave it blank to omit the fallback.

Handling image URLs

If you set an OG image (or default share image) to a path relative to your site root (one starting with a /) Chinaski resolves it against your Site URL setting during the build, so social platforms see a complete URL. Absolute URLs (like https://…) and values without a site URL configured are passed through unchanged.

Theme templates

If you build themes yourself, the template context includes og_title, og_description, og_image_url, and the default site image (both relative and absolute), so custom markup can reuse the same values. Including the shared meta-tags snippet in your theme keeps the Open Graph output consistent with the stock site.