Image Hotspots Field for ACF
Capture coordinates on images for interactive hotspots. Fork with full Gutenberg block editor support.
Consider an alternative
Image Hotspots Field for ACF shows warning signs in 2026 — compare the alternatives below before installing. It runs on 100+ sites and was last updated 10 months ago, and scores 40/100 on our health check.
- Small user base (100+ active installs)
- Very few reviews so far
- Only tested up to WordPress 6.8 (latest is 7.1)
How does it stack up?
Side-by-side on installs, updates, ratings & support
Daily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where Image Hotspots Field for ACF stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| acf | >100 |
| advanced custom fields | >100 |
| coordinates | #97 |
| hotspots | #36 |
| image mapping | #53 |
Version adoption
Share of active sites per release.
About Image Hotspots Field for ACF
From the official readme · v0.2Description
This plugin adds a custom ACF field type that allows users to click on an image and capture X/Y coordinates. Perfect for creating interactive image maps, product hotspots, or any feature requiring precise coordinate-based positioning.
This is a fork of the original ACF Image Hotspots Field by Andrew Rockwell, enhanced with full support for ACF blocks in the Gutenberg editor.
Key Features
- Click on an image to capture precise X/Y coordinates
- Supports both pixel-based and percentage-based coordinates
- Links to existing ACF image fields
- Visual marker shows the selected position
- Works in regular ACF field groups AND ACF blocks
- NEW: Full Gutenberg block editor compatibility
- Compatible with ACF 5.8+
What’s New in This Fork
This fork adds critical improvements for modern WordPress development:
- Gutenberg Block Support: Works seamlessly in ACF blocks within the Gutenberg editor
- Event Capture Fix: Solves the issue where Gutenberg intercepts click events
- Improved DOM Search: Enhanced field discovery in complex block structures
- Enhanced Visibility: Fixed z-index and marker visibility in block contexts
- Auto-Refresh: Automatically updates block previews when coordinates change
Original Plugin
Original plugin by Andrew Rockwell – Thank you for creating this excellent field type!
This fork maintains 100% backwards compatibility with the original while adding modern editor support.
How to Use
- Install and activate the plugin
- Create a custom ACF field of type “Image Mapping”
- In field settings, enter the name of an existing ACF image field to link to
- Add an image to the linked field
- Click on the image in the hotspot field to capture coordinates
- Coordinates are stored as comma-separated strings (e.g., “150px,200px” or “45.5%,60.2%”)
Works in both ACF field groups and ACF blocks!
Compatibility
This ACF field type is compatible with:
- ACF 5.8+
- WordPress 5.8+
- Gutenberg block editor
- Classic editor
- PHP 7.2+
Credits
Original Plugin: Andrew Rockwell (rockwell15, eridesign)
Gutenberg Fork: Levels Branding and Development
Thank you to Andrew Rockwell for creating the original plugin!
Support
For issues specific to this plugin:
* GitLab: https://gitlab.com/levels-dev/plugins/advanced-custom-fields-image-hotspots-field-fork
For general ACF questions:
* ACF Documentation: https://www.advancedcustomfields.com/resources/
Other Plugins by Levels
Check out our other WordPress plugins:
- Ready-Made Oxygen Integration – Seamless integration for Oxygen Builder with pre-built components and utilities
Visit levels.dev/plugins for more tools and resources.
Technical Details
This fork includes a sophisticated event capture system that intercepts mouse events before Gutenberg’s React event system can prevent them. The plugin uses native JavaScript addEventListener with capture phase to ensure reliable coordinate capture in all contexts.
For detailed technical information, see the GUTENBERG_FIX.md file in the plugin directory.
Installation
Automatic Installation
- Go to Plugins > Add New
- Search for “ACF Image Mapping Hotspots”
- Click “Install Now” and then “Activate”
Manual Installation
- Download the plugin
- Upload the
acf-image-mapping-hotspotsfolder to/wp-content/plugins/ - Activate the plugin through the ‘Plugins’ menu in WordPress
- Create a new ACF field and select “Image Mapping” as the field type
Frequently asked questions
Does this work with ACF blocks in Gutenberg?
Yes! This is the primary enhancement in this fork. The original plugin didn’t work in ACF blocks due to event interception issues, which have been completely resolved.
Can I use percentage-based coordinates?
Yes, enable the “Percentage Based Coordinates” option in the field settings. This is useful for responsive designs where the image size may vary.
Does this work with repeater fields?
Yes, the field automatically searches through repeater parent fields to find the linked image.
Is this backwards compatible with the original plugin?
Yes, 100%. You can safely switch from the original plugin to this fork without any breaking changes.
How do I retrieve coordinates in my template?
Use standard ACF functions: $coords = get_field('hotspot_field_name'); list($x, $y) = explode(',', $coords);
Does this require ACF Pro?
No, it works with both free ACF and ACF Pro. However, using it in ACF blocks requires ACF Pro 5.8+.
Changelog
Branding update with plugin name change to match WordPress.org slug. No functional changes.
0.2 (2025-12-05)
- Updated plugin branding to Levels Branding and Development
- Updated plugin name to “Image Hotspots Field for ACF” for WordPress.org consistency
- Minor documentation updates
0.1 (2025-01-29)
- Fork created with Gutenberg support
- Added event capture phase interception for ACF blocks
- Improved DOM search for block contexts
- Added CSS fixes for z-index and visibility
- Added automatic block preview refresh on coordinate change
- Enhanced documentation with debugging guides
- Updated for WordPress 6.8 compatibility
- Updated for ACF 5.8+ compatibility
- Tested with PHP 8.0+
- 100% backwards compatible with original plugin
0.0.1 (Original by Andrew Rockwell)
- Initial release of ACF Image Hotspots Field
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
Best Image Hotspots Field for ACF alternatives
All acf plugins →
FAQ
Image Hotspots Field for ACF: quick answers
Straight answers, pulled from live WordPress.org data.
Live data from WordPress.org · checked Sep 28, 2026
Is Image Hotspots Field for ACF free?
Yes. Image Hotspots Field for ACF is free to download and use from the official WordPress.org plugin directory.
Is Image Hotspots Field for ACF safe to use in 2026?
Image Hotspots Field for ACF shows warning signs in 2026 — compare the alternatives below before installing. It runs on 100+ sites and was last updated 10 months ago, and scores 40/100 on our health check.
How many websites use Image Hotspots Field for ACF?
Image Hotspots Field for ACF is active on 100+ WordPress websites and has been downloaded 1,736 times since it launched in December 2025. It was downloaded 116 times in the last 30 days.
Does Image Hotspots Field for ACF work with WordPress 7.1?
Image Hotspots Field for ACF is officially tested up to WordPress 6.8.10, while the latest release is 7.1.2. It may still work, but try it on a staging site first.
What PHP version does Image Hotspots Field for ACF need?
Image Hotspots Field for ACF requires PHP 7.2 or higher. Most hosts run PHP 8.x today, so it works on any modern WordPress hosting.
When was Image Hotspots Field for ACF last updated?
The latest version, 0.2, was released on December 5, 2025 (10 months ago).
Who makes Image Hotspots Field for ACF?
Image Hotspots Field for ACF is developed and maintained by Levels Branding and Webdevelopment.
What are the best alternatives to Image Hotspots Field for ACF?
The most popular alternatives to Image Hotspots Field for ACF are Advanced Custom Fields (ACF… (2M+ installs), ACF Content Analysis for Yo… (100K+ installs) and Advanced Custom Fields: Ext… (100K+ installs).
Powered by PageForge
Want thousands of pages that rank like these? Build them in an afternoon.
This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.
- CSV, Google Sheets & API data sources
- AI content, schema & internal links per page
- Works with Elementor, Gutenberg, Yoast & Rank Math
- Free on WordPress.org — no credit card
