Image Hotspots Field for ACF
Capture coordinates on images for interactive hotspots. Fork with full Gutenberg block editor support.
Plugin info
Maintenance & Compatibility
Maintenance score
Actively maintained • Last updated 26 days ago
Is Image Hotspots Field for ACF abandoned?
Likely maintained (last update 26 days ago).
Compatibility
Similar & Alternatives
Explore plugins with similar tags, and compare key metrics like downloads, ratings, updates, support, and WP/PHP compatibility.
Description
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
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.
Yes, enable the “Percentage Based Coordinates” option in the field settings. This is useful for responsive designs where the image size may vary.
Yes, the field automatically searches through repeater parent fields to find the linked image.
Yes, 100%. You can safely switch from the original plugin to this fork without any breaking changes.
Use standard ACF functions:
$coords = get_field('hotspot_field_name');
list($x, $y) = explode(',', $coords);
No, it works with both free ACF and ACF Pro. However, using it in ACF blocks requires ACF Pro 5.8+.
Review feed
Screenshots
Changelog
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