Docs
← Back to site

Product Images & Descriptions

2 min readUpdated October 29, 2026

A product’s image and description are both optional, but they appear in several places once set, so it’s worth filling them in for any product you want to look polished for readers.

Setting them#

Both fields live on the product itself, under WP Super Docs → Products:

  • Description: a plain text field, the same as the description field on any WordPress category or tag. It doesn’t support HTML or Markdown formatting, so keep it to a sentence or two of plain text.
  • Product image: click Choose image to select one from your media library, or Remove to clear it. WP Super Docs uses the WordPress “medium” image size when displaying it.
The Edit Product screen with the product description and image.

Where they appear#

LocationImageDescription
Docs index (/docs/) product cardsYesYes
Product page (/docs/{product}/) headingNoYes, shown as a lead paragraph under the product name
Product switcher modalYesYes
Combined product changelog pageYesYes

The image and description are both hidden on the product page itself when you’re running in single-product mode, since the heading they’d support (the product name) is hidden too. They still appear on the docs index and switcher in multi-product sites.

Writing a good description#

Since the description shows up as a short lead-in on the product page and as a subtitle on cards elsewhere, treat it as a one-line pitch for the product rather than a full introduction. Save longer context for the product’s actual docs.

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