Image hotspots can explain parts of a diagram, product or place without adding a long label directly over the picture. Use them for genuinely useful detail and keep the main explanation available in text. An essential instruction should not depend entirely on hovering over a small point on an image.
Choose an image with meaningful areas
Use a diagram or photograph whose parts benefit from explanation. Avoid adding points to an image only because the effect looks interactive. Identify the subject and purpose in the surrounding page text so readers know why the image is there before opening a hotspot.
Add points against the final crop
Insert Hotspot Image and position markers on the image version you intend to publish. Changing the crop or replacing the source later can move the apparent relationship between a marker and its subject. Check the desktop and phone display before adding many points.
Write concise, specific labels
Give each hotspot a distinct title and a short useful explanation. Avoid a series of points that all say learn more without naming what they explain. Put lengthy instructions or critical qualifications in ordinary page content rather than forcing them into a small popup.
Test supported input methods
Open each hotspot with the controls the selected block provides and try a touch screen as well as a mouse. Review keyboard access and the closing behavior of any popup. Check that overlapping markers do not make the intended target difficult to select.
Provide an understandable text route
Summarize the important parts below the image or link to a readable explanation. Review the marker positions after any image change. If the useful information is too extensive for a hotspot layout, use a labelled diagram and a clear list instead.
Before you finish
- Each point explains a meaningful area.
- Positions match the final crop.
- Labels are distinguishable.
- Important information is available outside hover.
Questions and answers
Are hotspots suitable for essential navigation?
Use caution. Important destinations should also be discoverable through clear ordinary links or controls, especially for touch and keyboard users.
Can I replace the background image without checking the points?
No. Revisit every marker after a replacement or crop change, because the same coordinates may indicate a different part of the picture.
Sources and scope
This guide uses Blockenberg’s documented editor workflows and block definitions available on November 1, 2026. Labels and provider availability can change. Test the result with your theme and plugins.
AI-assisted draft, checked against product sources. Examples are illustrative; they are not customer results or performance guarantees.