Product Images & Descriptions
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.

Where they appear#
| Location | Image | Description |
|---|---|---|
Docs index (/docs/) product cards | Yes | Yes |
Product page (/docs/{product}/) heading | No | Yes, shown as a lead paragraph under the product name |
| Product switcher modal | Yes | Yes |
| Combined product changelog page | Yes | Yes |
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?
Thanks for your feedback!
✓ Feedback received. Thank you!