Docs
← Back to site

Share Images

4 min readUpdated November 21, 2026

A share image is the picture Facebook, X, LinkedIn, Slack and other chat apps show when someone shares a link to your docs. WP Super Docs gives every page it creates a share image you choose, so a shared link to your docs homepage, a product, a category, a changelog or the roadmap never shows up as a plain grey box.

Docs and generated pages#

There are two kinds of pages on a docs site:

  • Docs are normal WordPress posts. A doc uses its featured image as its share image, or the image set for it in your SEO plugin or in Built-in SEO Meta.
  • Generated pages are the pages WP Super Docs builds itself: the docs homepage, product and category pages, the changelogs, the roadmap, feature requests and the 404 page. They have no edit screen of their own, so their share images are set under Settings → SEO.

Setting share images for each page type#

Go to WP Super Docs → Settings → Discoverability → SEO and scroll to Share images. Each row has a Choose image button that opens the Media Library, and a Remove link once an image is set. Click Save changes in the bar at the bottom of the page when you’re done.

Share images section in Settings, SEO, with an image picker for each page type
Row Where it’s used
Default Any docs page without a share image of its own, including docs without a featured image
Docs homepage The /docs/ page
Product pages Every product page, unless the product has its own image
Category pages Every category page, unless the category has its own image
Docs Updates page The list of recently updated docs
All products changelog The combined changelog of every product
Product changelog pages Each product’s changelog. When empty, the product’s own share image is used
Roadmap The roadmap board, for all products or one
Feature requests The feature requests board
Shipped The archive of shipped roadmap items
404 page Shown for docs addresses that don’t exist

Images of 1200 × 630 pixels work on every platform.

One docs homepage image per language#

On sites with WPML or Polylang, a row appears under Docs homepage for each language, for example Docs homepage: Deutsch. Set one to show a translated image on that language’s docs homepage. Leave it empty to use the main Docs homepage image.

A share image for one product or category#

Each product and each category can have its own share image, which wins over the page-type image above.

  1. Go to WP Super Docs → Products (or Doc Categories) and click Edit on the product or category.
  2. Find Share image and click Choose image.
  3. Click Update.
Share image field on a product's edit screen

Leave the field empty to use the image from Settings → SEO → Share images. The field is also on the category edit screen:

Share image field on a category's edit screen

Which image is used#

For a generated page, WP Super Docs uses the first image that is set, in this order:

  1. The category’s or product’s own share image.
  2. On a multilingual site, the docs homepage image for the current language.
  3. The image for that page type under Settings → SEO → Share images.
  4. The product’s own share image (for example on a product’s changelog or roadmap page).
  5. The Default image.

A doc always keeps its own image. The Default image is only used for a doc that has no featured image, no Built-in SEO Meta image and no image set in its SEO plugin.

With an SEO plugin#

Share images work with or without an SEO plugin, and there is always exactly one image tag on the page:

  • Slim SEO, Yoast SEO and Rank Math print the image themselves. WP Super Docs hands them the right image, so on generated pages your SEO plugin’s own default image is replaced. On these sites, the Share images section says so.
  • The SEO Framework, All in One SEO, SEOPress and SureRank: on generated pages the image comes from WP Super Docs, either passed to the plugin or printed by WP Super Docs in place of the plugin’s own tag.
  • With no SEO plugin, WP Super Docs prints the image itself.

See Open Graph Tags for the other share tags (title, description, address) on each SEO plugin.

Checking a share image#

After saving, paste the page’s address into a share preview tool, such as Facebook’s Sharing Debugger or LinkedIn’s Post Inspector. These tools keep a copy of what they saw last, so use their option to fetch the page again after you change an image.

Setting share images with Claude#

If Claude is connected (see Connecting Claude to Your Docs (MCP)), an Administrator can ask it to set share images, for example: “Use the image with the screenshot key share/roadmap as the roadmap’s share image.” Claude can set the image for a page type, a product, a category, or the docs homepage in one language, and list which images are set.

Was this helpful?

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only