Signal & Context
← Back to the reading room

Web Publishing

A shared page needs its own identity

Treat the title, canonical address and preview image as part of the published article, then inspect the actual public response.

On this page

The link travels without your navigation

A reader who opens a shared article may never see the publication's homepage. The page therefore needs enough context to stand alone: a useful title, a concise description, a clear source of publication, and an address that continues to identify that article. Its social preview and its visible content should make compatible promises.

The Open Graph protocol defines basic properties for representing a page, including its title, type, image and canonical object URL. Those fields describe the object being shared. Filling them with the site's generic slogan and homepage image loses the distinction between an article, a tool listing and a policy page.

Keep identity consistent

Choose a preferred public URL for each entry. Use it consistently in the page's canonical link, Open Graph URL, internal navigation and sitemap. Google's canonicalization documentation describes redirects and canonical annotations as signals and cautions against conflicting preferences. These mechanisms help communicate identity; they do not promise that a search engine will select or rank a page as requested.

When moving a publication from a path to a subdomain, inspect a real article rather than checking only the homepage. An old host embedded in an image URL or share link can survive a successful visual redesign. Keep a short mapping of old addresses to their replacements and verify destinations before making the previous location permanent history.

Make the preview readable on its own

A share image has a limited job. It should help identify the piece without requiring someone to decode a tiny screenshot. A short title and a restrained publication mark may be sufficient. Use a photograph or diagram when it explains the article, and preserve permission and attribution information for any external assets.

Vercel's Open Graph image documentation demonstrates generating images from markup and exposing their URLs through page metadata. Generation can keep a large catalogue consistent, but a small static publication can also prepare images during its build. Choose the simpler operating method for the amount of content you maintain. Dynamic rendering is an option, not a requirement for a useful preview.

Inspect the response that was published

Check the HTML returned by the public article URL, not just the values stored in the editor. Confirm that its metadata names the right entry and that each image can be fetched independently. Open an image at a small display size and read its title. Follow any redirect chain to ensure that the address and the article still agree.

Then inspect a preview on the platform you actually intend to use. Platforms can cache fetched information, and their displayed cards may differ. Keep that observation separate from your source-code check. Neither a valid tag nor a successful HTTP response proves the final card's appearance, search indexing, or audience response. Each of those needs its own direct evidence.

Suggest a correction

Continue reading