Description
NoEmpty Image for Advanced Custom Fields allows WordPress developers and content creators to set a default fallback image directly within Advanced Custom Fields (ACF) Image field settings.
When editing a post, page, or custom post type where an ACF Image field is left empty, the plugin automatically provides the specified default image. This prevents broken layouts, eliminates the need for repeated fallback conditional checks in template files, and ensures a seamless display across your entire WordPress site.
Developed and maintained by Abdul Rehman.
Key Features
- Native ACF Field Setting: Adds a “Default Image” uploader directly inside any ACF Image field settings.
- Automatic Fallback: Returns the default image whenever a post or page has no image selected.
- Full ACF Return Format Compatibility: Works seamlessly with all ACF return formats:
- Image Array
- Image URL
- Image ID
- Lightweight & Fast: Zero frontend overhead; hooks directly into ACF’s native value loading pipeline.
- Extensible for Developers: Provides the
noempty_image_for_acf_valuefilter hook for dynamic conditional fallbacks. - ACF PRO & Secure Custom Fields (SCF) Compatible: Supports Advanced Custom Fields (Free & PRO) as well as Secure Custom Fields.
- Fully Compatible with PHP 8.x and Latest WordPress: Clean, secure, and compliant with WordPress coding standards.
Screenshots
Installation
From WordPress Dashboard:
- Log in to your WordPress admin dashboard.
- Navigate to Plugins Add New.
- Search for
NoEmpty Image for Advanced Custom Fields. - Click Install Now, then click Activate.
Manual Installation:
- Download the plugin ZIP package (
noempty-image-for-acf.zip). - Log in to your WordPress dashboard and go to Plugins Add New Upload Plugin.
- Choose the downloaded ZIP file and click Install Now.
- Click Activate Plugin.
Note: Make sure Advanced Custom Fields (ACF) or Secure Custom Fields is installed and activated.
FAQ
-
Does this plugin require Advanced Custom Fields?
-
Yes, this plugin is an add-on for Advanced Custom Fields (Free or PRO) and also works with Secure Custom Fields (SCF).
-
How do I set a default image for an ACF image field?
-
- Go to Custom Fields Field Groups in your WordPress admin.
- Edit or add an Image field.
- Under the field settings, locate the Default Image setting.
- Click Add Image to choose or upload your default image from the media library.
- Save the field group.
-
What return formats are supported?
-
All three ACF return formats are supported: Image Array, Image URL, and Image ID. The plugin returns the default image in whichever format your field is configured to return.
-
What happens if the default image is deleted from the Media Library?
-
The plugin includes a safeguard check. If the selected default image has been deleted from your Media Library, it safely falls back to returning false or empty to prevent PHP warnings or broken links.
-
Is it compatible with PHP 8+ and latest WordPress?
-
Yes, the plugin is fully tested and compatible with PHP 7.4 through PHP 8.4, and the latest versions of WordPress.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“NoEmpty Image for Advanced Custom Fields” is open source software. The following people have contributed to this plugin.
Contributors
Translate “NoEmpty Image for Advanced Custom Fields” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0
- Initial release by Abdul Rehman.
- Fully compatible with WordPress 6.x / 7.x and PHP 7.4 through 8.4.
- Enhanced ACF compatibility (supports ACF Free, ACF PRO, and Secure Custom Fields).
- Improved code architecture with safe dependency checking.
- Added attachment verification to prevent broken image references if default image is deleted.
- Added developer filter hook
noempty_image_for_acf_value. - Translation-ready with internationalization support.