Umbraco.Community.ImageHotspot

Image Hotspot

An Umbraco property editor that allows an editor to place a hotspot on an image.

This property editor provides similar functionality to what was previously available with the Vokseverk.ImageHotspot data type in Umbraco, versions 7-13.

It's a property editor that displays an image and lets the editor place a hotspot on it.

Installation

Add the package to an existing Umbraco website (v15+) from NuGet:

dotnet add package Umbraco.Community.ImageHotspot

Note: If you are upgrading from v13 and below, using Vokseverk.ImageHotspot, you need to update your Data Type configurations to use this editor.

Backoffice setup

1. Create a Data Type

1. Go to Settings → Data Types and create a new Data Type.
2. Select Image Hotspot as the property editor.
3. Configure the settings:
   • Image — the alias of the media picker property that holds the image (default: image). The editor resolves this recursively, so it works inside Block List and Block Grid elements.
   • Width — display width of the image in the editor in pixels (default: 400).
   • Color — hotspot indicator colour: Red, Green, Blue, or Orange (default: Red).

2. Add properties to a Document Type

Add a Media Picker property (single image) with the alias you configured above (e.g. image), then add an Image Hotspot property using the Data Type you just created.

When a content editor opens that document, they will see the referenced image and can click (or drag) to place the hotspot.

Using the value in code

The included ImageHotspotPropertyConverter runs automatically and converts the stored JSON into a strongly-typed ImageHotspotValue object via ModelsBuilder.

ImageHotspotValue properties

public class ImageHotspotValue
{
    public decimal PercentX { get; set; }  // X as a percentage (0–100)
    public decimal PercentY { get; set; }  // Y as a percentage (0–100)
}

ToString() returns a ready-made CSS snippet (left: X%; top: Y%;) for use directly in a style attribute.

Razor example

@{
    var hotspot = Model.Hotspot; // ImageHotspotValue — property alias "hotspot"
    var image = Model.Image;     // IPublishedContent — property alias "image"
}

@if (hotspot != null && image != null)
{
    <div style="position:relative; display:inline-flex;">
        <img src="@image.Url()" alt="" />
        <span style="
            position: absolute;
            width: 12px;
            height: 12px;
            border-radius: 50%;
            background: red;
            transform: translate(-50%, -50%);
            @hotspot
        "></span>
    </div>
}

The @hotspot interpolation expands to left: 55.75%; top: 74.878%;.

Accessing coordinates directly

var hotspot = Model.Value<ImageHotspotValue>("hotspot");
if (hotspot != null)
{
    // Use percentage coordinates (0–1 range)
    double x = (double)hotspot.PercentX; // e.g. 0.5575
    double y = (double)hotspot.PercentY; // e.g. 0.7488
}

More information

Full documentation and source code: github.com/skttl/umbraco-image-hotspot