Docs
← Back to site

Setting Category Icons (emoji or image)

2 min readUpdated October 29, 2026

Each category can have an icon: an emoji, a short bit of text, or an uploaded image. It’s entirely optional, but it makes a long sidebar much easier to scan at a glance.

Setting an icon#

  1. Go to WP Super Docs → Categories and open a category for editing (or set it while creating a new one).
  2. In the Icon field, either:
    • Type an emoji directly, for example 📘 or 🔧 or 🚀, or
    • Click Choose image to pick an image from your media library (PNG, SVG, or any image type your library supports).
  3. Save the category.
The Icon field on a category, with a rocket emoji and its preview.

It’s a single field either way. WP Super Docs detects which type you’ve used automatically: if the value is a URL, it renders as an image; otherwise, it renders as text/emoji.

Text and emoji length#

If you type text or an emoji rather than choosing an image, it’s capped at 16 characters. Anything longer is silently trimmed when the category is saved, so keep it to a single emoji or a couple of characters rather than a word or phrase.

Where icons appear#

The docs sidebar with an emoji icon next to each category heading.

Icons show up in three places, always next to the category name:

  • The sidebar navigation on doc pages
  • The mobile navigation drawer
  • The category cards on each product’s page (/docs/{product}/)

A category with no icon set still displays normally everywhere, just without an icon next to its name.

Removing an icon#

Open the category, clear the field (or click Remove if you’re editing an existing icon), and save. This deletes the stored icon entirely rather than leaving it blank.

Multilingual sites#

If you’re using WPML or Polylang, the icon field is exposed as a translatable term field, so each language can have its own icon for the same category if you want one. See Setting Up WPML or Setting Up Polylang for more on translating categories generally.

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