Image Overlay Cues

Add numbered badges to your images so step-by-step photos are easy to follow.

Lauren Gray Avatar

Image Overlay Cues puts a small numbered badge on your images, so step-by-step photos and roundups are easy to follow. You choose which images get a number, and the count updates by itself as you add, remove or skip images.

Before you start

  • WordPress 5.8.3 or later
  • PHP 7.3 or later
  • The block editor. The plugin works on the core Image block.
  • Pro: WordPress 6.2 or later

Install

  1. In your WordPress dashboard, go to Plugins → Add New Plugin.
  2. Click Upload Plugin.
  3. Choose the plugin zip file.
  4. Click Install Now.
  5. Click Activate.

How to use

Number an image (free version)

  1. Open a post or page in the block editor.
  2. Add an Image block, or select one you already have.
  3. In the block sidebar, under Styles, choose Count.
  4. Do the same for each image you want numbered.

Number an image (Pro)

  1. Select an Image block.
  2. In the block toolbar, click the Enable overlay count button (the numbers icon). Click it again to turn the count off.
  3. With the count on, use the sidebar to change its colors and size (see Block options below).

Skip an image

Only images with the count turned on get a number, so just leave the others alone. The numbers stay in order and count up through the whole page, even across columns and other layout blocks.

Block options

With Pro, these controls show up on an Image block once its count is turned on.

  • Count Background Color (Color panel): the badge color. Defaults to white.
  • Count Text Color (Color panel): the number color. Defaults to black.
  • Count size (Dimensions panel): the size of the badge. Defaults to 1.2em.

The badge sits at the top left of the image, 0.5em in from each edge.

Customize with CSS

Numbered images get the is-style-ioc--image--count class. You can override these CSS variables:

  • --image-overlay-cues--image-count--size: badge size (default 1.2em)
  • --image-overlay-cues--image-count--top: distance from the top (default 0.5em)
  • --image-overlay-cues--image-count--left: distance from the left (default 0.5em)
  • --image-overlay-cues--image-count--right and --image-overlay-cues--image-count--bottom: use these to move the badge to another corner (default initial)
  • --image-overlay-cues--image-count--text: number color (default #000)
  • --image-overlay-cues--image-count--bg: badge color (default #fff)
.entry-content .is-style-ioc--image--count {
    --image-overlay-cues--image-count--size: 1.6em;
    --image-overlay-cues--image-count--text: #fff;
    --image-overlay-cues--image-count--bg: #000;
}

What Pro adds

  • An Enable overlay count button in the Image block toolbar, in place of the Count block style
  • Count Background Color and Count Text Color controls
  • A Count size control

Developer reference

Coming soon: the hooks, filters and functions you can use with this plugin from your theme or a code snippet.

FAQs

Can I add custom text on top of an image?

Not anymore. Custom text overlays were removed in version 2.0.0. Use the core Cover block for text on an image.

Why are my numbers wrong inside a certain layout?

That’s a known limitation. Images inside a CSS container query (container-type: inline-size) may show the wrong count.

Does the count start over in each section?

No. There’s one count for the whole page, so numbers keep going across columns, groups and other layout blocks.