Description
DualFocus lets editors set one or two focal points for an image in the WordPress Media Library or Gutenberg editor. When a theme or block already uses a cover crop, DualFocus adjusts the image position to help keep those points visible.
Features:
* One or two focal points per Media Library image.
* Live Gutenberg editing with Save, Cancel, and Clear controls.
* Automatic positioning in the Gutenberg editor and on the frontend.
* Support for images inside Gutenberg galleries.
* Live crop previews and a clear notice when no crop is needed.
* No forced cropping, duplicate image files, external services, or custom database tables.
Focal points belong to the Media Library attachment, so instances of the same image share saved coordinates. Images without configured focal points keep their normal WordPress rendering. DualFocus only repositions an existing crop; it does not create a crop when the full image already fits.
The plugin is free. An optional donation link is provided in the admin interface.
Installation
- Upload the plugin ZIP under Plugins > Add New Plugin > Upload Plugin, or install it from the WordPress Plugin Directory once available.
- Activate DualFocus.
- Choose an image in Media Library or the Gutenberg editor and set one or two focal points.
- Save the points and use an Image block or gallery with a cropped aspect ratio to see the effect.
- Optionally use Settings > DualFocus Preview to compare crops.
FAQ
Does DualFocus crop or change the original image?
No. It only adjusts positioning where a crop already exists.
Why does moving a focal point sometimes appear to do nothing?
If the image is fully visible, there is no crop to reposition. Try a cropped aspect ratio in the block settings.
Can I use different focal points for two copies of the same image?
Not in this version. Focal points are saved on the shared Media Library attachment.
Does it work with Divi 5?
A separate Divi 5 companion integration is planned. Core focuses on WordPress and Gutenberg.
Does it load third-party scripts or require a paid service?
No. Admin screens use WordPress-bundled jQuery; frontend positioning uses vanilla JavaScript. Donations are optional.
Changelog
1.0.4
- Fix a React hook-order error that could cause the Gutenberg Image block to fail to preview when an image was selected.
1.0.2
- Show the no-crop explanation prominently beneath Gutenberg sidebar previews.
1.0.1
- Improve live editing support for images inside Gutenberg galleries.
- Explain when the image has no visible crop to reposition.
1.0.0
- Initial release with two-point focal positioning, live Gutenberg editing, and automatic editor positioning.
