PixMapr Lite: Interactive Image Hotspots

By Walter Pinem

★ 5.0/5 (1 ratings)60+ active installationsVersion 1.1.0

Turn any image into clickable hotspots. Unlimited images and hotspots, keyboard accessible, embedded with a block or shortcode.

Description

PixMapr Lite turns a static image into something visitors use. Draw polygon, circle, or rectangle hotspots straight on the picture, give each one a title, text, an image, or a link, and embed the result anywhere with the PixMapr block or the [pixmapr] shortcode.

No coordinates to type, no external service, no account. Everything is drawn and stored on your own site.

Free, and enough for real work:

  • Unlimited interactive images: no cap, no counter.
  • Unlimited hotspots per image: polygon, circle, and rectangle, traced on the image itself.
  • Two layouts: an info panel beside the image, or a tooltip that follows the hotspot.
  • Click or hover to open a hotspot.
  • Info panels and links: a title, rich text, and an image per hotspot, or send visitors to any URL.
  • Five color themes: Light, Dark, PixMapr, Suzette, and Autumn.
  • A panel that widens: a tab on the info panel widens it over the image, so videos, audio, and long reads get room.
  • Markers your way: dots that can pulse, or an emoji or image of a hotspot’s own.
  • Previous and Next buttons that step through the hotspots like a guided tour.
  • A sample to start from: one click makes a ready-made interactive image to explore.
  • Phone-friendly: a tappable hotspot list replaces hard-to-hit shapes on small screens.
  • Accessible: keyboard navigation, ARIA labels, and screen reader announcements out of the box.
  • Block and shortcode: works in the block editor, the Classic Editor, Divi, and any builder that renders shortcodes.
  • Light on the page: serve a smaller image size than the original and lazy-load images near the viewport.
  • Your own themes: five ready-made palettes, a theme builder for your own, and alternate highlight styles per image.
  • Translation-ready and RTL-ready.
  • AI agents, if you want them: an AI app can read your images and, if you allow it, edit hotspot text and draw hotspots, with every change marked for your review and a one-click Undo for hotspot changes. Off by default.

AI agents

PixMapr Lite can let an AI app work on your interactive images through the free MCP Adapter plugin (WordPress 6.9 or newer). It is off until you choose Read only or Read and edit under PixMapr Lite → Settings → AI agents.

  • An agent can list and read your images, list Media Library pictures, create a draft image from a Media Library picture, and change, add or replace hotspots.
  • It cannot publish a draft, delete an image, upload files, fetch anything from other sites, or change settings. It signs in as a WordPress user with an application password and reaches only the images that user may edit.
  • Drafts stay drafts, but a change to a published image is live at once, as if you had clicked Update. Review comes afterwards: for anyone who may edit the image, the images list marks it “Agent changes to review”, with a filter and a count, and its edit screen names every user whose agent changed it since the last review.
  • Undo: the notice offers one-click Undo for hotspot changes. A draft an agent created without changing hotspots gets Dismiss instead; delete the draft to undo it. If someone changed the hotspots after the agent, Undo is refused so that later work is not thrown away, and the hotspots stay as they are. PixMapr Lite keeps no history of earlier versions, so to remove what the agent did, edit those hotspots yourself.
  • Start with Read only, and give the agent a user that can edit only its own images (an Author) until you trust the workflow.
  • Agents are strong at text and bulk work: titles, descriptions, translations, links, restyling, and maps from coordinates you already have.
  • They are weaker at drawing hotspots from the picture alone. In one trial of our own (one AI model, two clean pictures with well separated objects), 11 of 16 first outlines were good as drawn and 5 needed a nudge. Busy photos, small objects or weaker models will do worse. The agent drafts, you fine-tune.
  • The agent must be able to open the picture’s web address to see it, so an AI service cannot draw on a site that runs on your own computer.

The setup guide walks through it step by step.

What could you make?

  • A floor plan where every room opens its photo and description.
  • A product photo where each part explains itself.
  • An annotated map, chart, or infographic.
  • A team photo that links each face to a profile.
  • A modern replacement for an HTML image map that works on phones.

PixMapr Pro

PixMapr Pro is the full plugin, built and used by the people who run the Online Store Kit stores:

  • Unlimited interactive images
  • Six layouts: left, right, top, bottom, lightbox, and tooltip
  • Numbered markers with a matching legend
  • Pan, zoom, and fullscreen for large maps and floor plans, with a separate phone layout
  • WooCommerce hotspots: tag products and sell from the picture, with add to cart that works without a page reload
  • 20+ themes
  • Engagement counts: image views and hotspot opens, counts only, no personal data
  • Export and import images, themes, and settings as one file
  • Ten automatic snapshots of every image, and one-click duplicate
  • Elementor widget and Beaver Builder module
  • A year of signed automatic updates and email support

Pro and Lite share the same images, so upgrading is install-and-activate: nothing to migrate, nothing to redraw. Lite can even stay active alongside Pro.

Privacy

PixMapr Lite does not call any external service and stores no visitor data. The only outbound links are the ones in its own admin screens.

AI agent access is off by default. If you turn it on and connect an AI app, that app reads and changes your images through the MCP Adapter plugin, signed in as a WordPress user you choose, and what it reads goes to the company that runs the app. PixMapr Lite itself still sends nothing anywhere.

Credits

Drawing and rendering are built on three bundled open-source libraries:

Full copyright notices and licence texts ship with the plugin in
THIRD-PARTY-NOTICES.txt. Un-minified sources for all three are in
assets/src/ and from the upstream projects above.

Installation

  1. Go to Plugins → Add Plugin and search for “PixMapr”.
  2. Install and activate PixMapr Lite.
  3. Go to PixMapr Lite → Add New, choose an image, and draw your first hotspot.
  4. Add the PixMapr block to any page or post, or paste the [pixmapr id="123"] shortcode shown on the edit screen.

Manual install

  1. Upload the pixmapr-lite folder to /wp-content/plugins/.
  2. Activate the plugin from the Plugins screen.

FAQ

What is the difference between Lite and Pro?

Lite builds unlimited interactive images with unlimited hotspots, two layouts (info panel and tooltip), five themes, and hotspots that open an info panel or a link, with no cap on any of it.

Pro is a bigger plugin: four more layouts including a lightbox, numbered markers with a matching legend, pan/zoom/fullscreen, WooCommerce product hotspots, fifteen more themes, engagement counts, export/import, snapshots, and the Elementor and Beaver Builder integrations. Compare the two.

Is there a limit on how many images I can make?

No. Build as many interactive images as you like, with as many hotspots on each as you like.

Do I need to uninstall Lite to use Pro?

No. Install Pro and Lite steps aside automatically. Both plugins use the same images, so everything you drew is already there.

Does it work in Elementor, Divi, or the Classic Editor?

The [pixmapr] shortcode works in any editor or builder that renders shortcodes, including Elementor, Divi, and the Classic Editor. The block editor gets a dedicated PixMapr block. A native Elementor widget and Beaver Builder module are part of Pro.

Does it work on phones?

Yes. The info panel and tooltip layouts adapt to small screens, and a tappable hotspot list can replace shapes that are too small to hit with a finger.

Is it accessible?

Yes. Hotspots can be reached and opened with the keyboard, carry ARIA labels, and info panels announce their content to screen readers.

Can an AI agent edit my interactive images?

Yes, if you allow it. Agent access is off until you choose Read only or Read and edit under PixMapr Lite → Settings → AI agents. It needs WordPress 6.9 or newer and the free MCP Adapter plugin. Agents are good at text and bulk work; hotspots they draw by looking at the picture are a first draft that you check. An agent’s hotspot changes can be undone in one click from the image’s edit screen. The setup guide covers each step.

Do I approve an agent’s changes before visitors see them?

Not on a published image. Drafts an agent creates stay drafts until you publish them, but a change an agent makes to a published image is live at once, as if you had clicked Update in the editor. You review afterwards: the images list marks the image “Agent changes to review”, and its edit screen offers one-click Undo for hotspot changes. To keep agent work away from visitors, start with Read only, or give the agent a user that can edit only its own images.

Which user should an AI agent use?

Its own, never your administrator account. Start with an Author: it can edit only the images it creates, which stay drafts until you publish them. Make it an Editor, so it can work on images that already exist, once you trust the workflow, and remember that its changes to published images go live at once. Then create an application password on that user’s profile for the AI app. You can revoke it at any time.

Where do I get help?

Post in the support forum. The documentation covers both editions.

Where do I report a security issue?

Please use the contact form rather than the public forum, so it can be fixed before it is disclosed.

Screenshots

Changelog

1.1.0

  • Security: fixes several security issues found in an internal review. Updating is recommended.
  • New: AI agent support, off by default. Choose Read only or Read and edit under Settings, AI agents, and an AI app connected through the free MCP Adapter plugin (WordPress 6.9 or newer) can list and read your interactive images, list Media Library pictures, create draft images, and change, add or replace hotspots. Drafts it creates stay drafts, but its change to a published image is live at once, as if you had clicked Update. It never publishes a draft, deletes an image, uploads, or fetches from other sites, and it reaches only the images its WordPress user may edit. Agents are good at text and bulk work; hotspots drawn from the picture alone are a draft to check.
  • New: images with agent changes are marked “Agent changes to review” in the images list, with a filter and a count. The image’s edit screen names every user whose agent changed it since the last review, says when the image is already live, and offers one-click Undo for hotspot changes.
  • New: an agent can send if_unchanged_since with a change, so the change is refused, and the agent told to read the image again, if someone changed it in the meantime.
  • New: the AI agents tab lists what an agent needs and whether the site has it: WordPress version, access level, the MCP Adapter (also when another plugin, such as Elementor, runs it), and application passwords.
  • New: the sample image is now a gaming desk with eight products, marked by small pulsing orange dots. Each product opens in the information box on the left with its picture and Previous and Next buttons. A sample made earlier is left as it is.
  • Changed: an image with a password shows WordPress’s password form where it is embedded, and drafts and private images follow WordPress’s own visibility rules when embedded.
  • Changed: on a page with more than one PixMapr image, every image after the first has a wrapper id starting with pixmapr- instead of hotspot-, so no two elements share an id. Custom CSS aimed at #hotspot-{image}-{n} needs #pixmapr-{image}-{n}. Links to hotspots work as before.
  • Changed: a hotspot’s picture uses its Media Library entry only when that entry matches the address saved beside it. A picture whose address was changed by hand after picking shows from its address alone, without the extra sizes WordPress keeps for library pictures.
  • Fixed: an interactive image placed inside itself, in one of its descriptions, its default text or a link, now shows nothing there instead of rendering itself again.
  • Fixed: alternate hotspot styles now show on the front end.
  • Fixed: markers no longer show a tooltip drawn by the browser. Pointing at a marker shows its hotspot’s own label and hover style, and a hotspot opened by hovering stays open while the pointer is on its marker.
  • Fixed: pointing at a hotspot no longer shows the image’s title in a second tooltip drawn by the browser. Screen readers still announce the title.
  • Fixed: hover labels and popups stay readable and fully opaque on images saved without colors of their own.
  • Fixed: on right-to-left sites, hotspots and markers stay on the picture, and label arrows point at their hotspot.
  • Fixed: long words in hotspot titles wrap instead of being cut off.
  • Fixed: in a narrow column, the information box beside the image now moves under it instead of squeezing hotspot titles, whatever the screen width.
  • Improved: in the information box beside the image, the hotspot’s picture is sized to fit the box. When the text is longer than the box, the text scrolls while the Previous and Next buttons stay at the foot of the box.
  • Fixed: backslashes in hotspot text are kept when you save.
  • Fixed: pages that use the [pixmapr] shortcode now load the plugin’s stylesheet and script in the page head, as image pages already did.
  • Fixed: the steps that should run once after an update were skipped. They now run.
  • Fixed: an interactive image’s own page (View Interactive Image and Preview) now uses your theme’s header, navigation and footer on block themes such as Twenty Twenty-Five, instead of a bare page with deprecation notices.
  • Fixed: on an interactive image’s own page, the theme no longer prints the picture a second time as a featured image. On an image with a password, that sent the picture to visitors who had not entered the password.
  • Fixed: uninstalling PixMapr Lite no longer removes the settings it shares with PixMapr Pro when Pro is installed in a folder with a different name. Lite now recognizes Pro by more than its folder name.
  • Improved: PixMapr.allSpots and PixMapr.infoSpots are lookup objects with no prototype. Code that calls .hasOwnProperty() on them directly needs Object.prototype.hasOwnProperty.call() instead.

1.0.3

  • New: Start from a sample. The first-run screen and the images list can create a ready-made interactive image to explore and change.
  • New: each hotspot can have its own marker: an emoji or an image, with its own color and size. A hotspot with its own icon or image shows it even when the image has markers turned off.
  • New: Previous and Next buttons step through an image’s hotspots in order, in the information box and click tooltips. Turn them on site-wide in Settings, per image, or in the block and the shortcode (tour).
  • New: markers can pulse, so visitors see at a glance that the image has more to show (marker_animation). They stay still for visitors whose device asks for reduced motion.
  • New: a link button on each hotspot in the editor copies an address that opens the image with that hotspot already open.
  • New: Copy style and Paste style on each hotspot give several hotspots the same highlight style and marker.
  • New: hotspots that go to a web address can be marked Nofollow, or Sponsored for paid and affiliate links.
  • New: move a hotspot’s shape a pixel at a time with the arrow keys, ten with Shift.
  • New: the image editor warns before you leave it with unsaved changes.
  • New: after two weeks of use and a first published image, a notice on PixMapr screens asks administrators once whether they would rate the plugin on WordPress.org. Maybe later and Don’t ask again both work.
  • New: the information box beside the image can widen over it like a sidebar sliding out, so videos, audio and long descriptions get room. A tab on its edge, or the Esc key, widens and narrows it.
  • New: settings for the widening box, site-wide and per image: whether the tab shows, how far the box widens (40% to 100% of the image), and whether it widens by itself for videos, audio and embeds, or for every hotspot. The block and the shortcode have them too (expand, expand_width, expand_auto).
  • Improved: scrollbars in the information box and tooltips are thin and take the box’s own colors, so they match every theme.
  • Improved: the block editor preview no longer shows the phone-only hotspot list under the image.
  • Improved: tooltips long enough to scroll no longer show grey lines above and below the text.
  • Fixed: Open in New Window on hotspots that go to a web address opened the link in the same tab.
  • Fixed: a link to a hotspot now opens it on images that open hotspots on hover.
  • Fixed: clicks inside a tooltip now reach the page’s own scripts, so buttons and links in a tooltip work as they do elsewhere on the page.
  • Fixed: opening an Elementor popup on a page with an image restarted that image, and its information box showed the introduction on top of the open hotspot.
  • Fixed: in themes that wrap videos in a frame of their own (Kadence, FitVids), videos in the information box were taller than the video, with an empty band above it.
  • Fixed: a color or other value that a hotspot field rejected was saved anyway.

1.0.2

  • Fixed: the background color around an image is now even on all four sides. When the page layout settled after loading, for example once a web font arrived, the image could end up with no border at the top and a thick one at the bottom.
  • Fixed: tooltips now open beside the hotspot’s marker instead of covering it.
  • Fixed: the hotspot editor no longer leaves an empty space on the left of each hotspot.

1.0.1

  • Fixed: tooltips could stop opening on pages where the theme or another plugin loads its own copy of the Leaflet map library. PixMapr now keeps working whichever copy loads last.
  • Fixed: lists, headings and paragraphs in a hotspot description now keep their formatting in the tooltip layout. Bullets and numbers show on every theme, and the tooltip uses the site’s own typeface at a readable size.
  • Fixed: the hotspot list no longer picks up a theme’s bullets and indent.
  • Improved: uploading a map image now shows a spinner with progress, and says when the image is being processed. A large image no longer looks as if nothing is happening.
  • Fixed: after uploading a map image and then removing it, the upload box could stay empty until the page was reloaded.
  • Improved: a file that is too large, of the wrong type, or refused by the server now says so in the Map Image box.

1.0.0

  • Initial release.