Docs

Hotspot

An image with markers that open tooltips.

On this page

The Hotspot widget places markers on an image. Each marker opens a tooltip with a title, a short text and an optional link. Use it to point out the details of a room, the parts of a product or the stops of a tour. Markers are positioned in percentages, so they stay in place when the image resizes.

A living room illustration with three round markers; the one on the sofa is open and shows a tooltip titled Moss velvet sofa with a short text and a See the project link
Three markers; the sofa marker's tooltip is open.

Add hotspots to an image

  1. Insert it

    Open Insert in the left panel, find Hotspot under Media (or type hotspot in Search widgets) and click it or drag it onto the canvas.

  2. Choose the image

    Pick the Image in Content → Image.

  3. Place the markers

    In Content → Hotspots, click a marker and set its Horizontal position and Vertical position in % from the top-left corner. Type its Title and Text, and add a Link if you like. Add item adds another marker.

  4. Choose how tooltips open

    Set Open tooltip on to Click / tap or Hover and focus, and pick the default Tooltip position.

Settings

Settings marked Per device can differ on desktop, tablet and mobile (see Responsive editing); marker positions can too, if the image is cropped differently on phones. The image supports dynamic tags (see Dynamic tags).

Content tab

Image
SettingWhat it does
ImageThe picture the markers sit on. Supports dynamic tags.
ResolutionThe image size WordPress serves. Smaller files load faster; pick one at least as wide as the image is shown. Default: Large.
Hotspots
SettingWhat it does
HotspotsThe markers. Add item, drag to reorder, Duplicate item and Delete item.
Open tooltip onOpens the tooltips on click or tap, or on hover and keyboard focus. Options: Click / tap, Hover and focus. Default: Click / tap.
Tooltip positionDefault side of the markers where tooltips open. Options: Top, Bottom, Left, Right. Default: Top.
Show title on the markerShows the title next to each marker. Otherwise it appears only in the tooltip (screen readers always read it).
Pulse animationAdds a soft pulsing ring around the markers. On by default.
Each hotspot
SettingWhat it does
TitleTitle of the marker, shown in its tooltip and read by screen readers.
TextText in the tooltip.
Horizontal positionHorizontal position of the marker, in % from the left edge of the image. Default: 50%. Per device.
Vertical positionVertical position of the marker, in % from the top edge of the image. Default: 50%. Per device.
IconIcon inside the marker.
LinkAn optional link in the tooltip.
Link textText of the link in the tooltip. Without text, the marker itself becomes the link.
Tooltip positionSide of the marker where this tooltip opens, instead of the default. Options: Default, Top, Bottom, Left, Right.

Design tab

Image
SettingWhat it does
Border radiusRounds the corners of the image. Per device.
CSS filtersBlur, brightness, contrast, saturation and hue of the image.
Markers
SettingWhat it does
SizeSize of the markers. Per device.
Icon sizeSize of the icons in the markers. Per device.
Title typographyText style or font, size, weight and spacing of the marker titles. Shown when Show title on the marker is on.
Normal › Icon colorIcon color of the markers.
Normal › BackgroundBackground color of the markers.
Hover / open › Icon colorIcon color on hover and while the tooltip is open.
Hover / open › BackgroundBackground color on hover and while the tooltip is open.
BorderBorder of the markers.
Border radiusRounds the markers; 50% makes them circles. Per device.
ShadowShadow of the markers.
Pulse colorColor of the pulsing ring. Shown when Pulse animation is on.
Tooltip
SettingWhat it does
Max widthMaximum width of the tooltips. Per device.
Distance from markerSpace between a marker and its tooltip.
BackgroundBackground color of the tooltips.
PaddingSpace inside the tooltips. Per device.
Border radiusRounds the corners of the tooltips. Per device.
ShadowShadow of the tooltips.
Title typographyText style or font, size, weight and spacing of the tooltip title.
Title colorColor of the tooltip title.
Text typographyText style or font, size, weight and spacing of the tooltip text.
Text colorColor of the tooltip text.
Link colorColor of the tooltip link.
Shared Design sections

Every element also has these sections at the end of the Design tab.

SectionWhat it does
Spacing & positionMargin, padding, width, alignment in its container, order, position (relative, absolute, fixed), offsets, z-index and global classes. See Spacing, size & position.
Background & borderBackground, border, border radius, box shadow, overflow and opacity of the whole element. See Colors & backgrounds and Borders & shadows.
MaskCrops the element to a shape (circle, arch, blob, star…) or your own SVG or PNG. See Shape dividers & masks.

Behaviour tab

Behaviour sections

The Behaviour tab is the same for every element.

SectionWhat it does
Anchor & classesAn Anchor ID for #links and your own CSS classes.
AnimationsEntrance, scroll, hover and loop animations from presets or your own timeline. See Motion & effects.
Motion & effectsA simple entrance animation, transforms (also on hover), CSS and backdrop filters, and sticky positioning.
Scroll & mouse effectsMovement, rotation, scale, fade and blur while the page scrolls, and pointer effects (follow the pointer, 3D tilt).
VisibilityHide the element on desktop, tablet or mobile, or in dark or light mode. See Visibility.
ConditionsShow the element only when rules match, such as logged-in visitors, a date range or a URL parameter. See Display conditions.
InteractionsShow, hide or change other elements when this one is clicked, hovered or scrolled into view. See Interactions.
AttributesCustom HTML attributes for this element. See Anchor, classes & attributes.

Tips

  • Click works everywhere. Click / tap suits touch screens; Hover and focus is handy on desktop, and tooltips still open with the keyboard.
  • Accessible markers. Each marker is a button named by its Title, and the Esc key closes an open tooltip. Keep titles meaningful even when Show title on the marker is off.
  • Few markers. Three to six markers keep the image readable. Turn off Pulse animation if the markers distract.
  • Tooltips near edges. Set a marker's own Tooltip position (for example Left for a marker near the right edge) so its tooltip stays inside the image.