ACFDebug
“Debug ACF fields on the frontend, check Bricks conditions and clean orphaned ACF data from your database. Admin-only WordPress plugin for developers.“
Debug your ACF data without leaving the page
ACFDebug is a WordPress plugin for anyone who builds with Advanced Custom Fields. It puts a debug bar at the bottom of your site’s frontend. The bar shows exactly what ACF is storing and returning for the page you are looking at. A second tool finds ACF data that is still in your database but no longer belongs to any field, and lets you remove it safely.
You no longer have to guess why a field is empty, why a condition fails, or why old data is still hanging around. You can see it, search it, copy it and clean it up.
A debug bar that shows what ACF actually returns
Switch ACFDebug on and open any page while logged in as an administrator. A compact dark panel appears at the bottom of the screen with a tab for each data source:
- Current post or page: every ACF field on the page you are viewing, with its label, name, key, field type, parent group and stored value.
- Options page: the same detail for all your ACF options fields.
- Current user: the ACF fields and raw meta of the logged in user, so you can check profile data, roles and custom user fields.
- Conditional Logic: the conditions behind your fields and your page elements (more on this below).
- Search: one search box that looks through every tab at once.
Nested content is handled too. Groups and repeaters are unpacked, so you can see sub fields and their values instead of a single unreadable array. Values that are objects, such as terms, are converted to readable text rather than breaking the output.
Search everything, then copy what you need
Debugging usually means hunting for one value among hundreds. The Search tab filters across the current page, the options page and the current user in one go. It builds a summary per tab, and you can copy that summary with a single click.
Copy buttons are everywhere. You can copy a single value, a full row, or an entire tab. That makes it easy to paste field data into a support ticket, a bug report, a message to a colleague or a document for a client.
See what your conditions really read
Dynamic data tags are convenient when you build, but they hide the actual value a condition compares against. ACFDebug makes that visible.
The Conditional Logic tab covers two kinds of conditions:
- ACF conditional logic: the rules attached to your fields, shown in readable form and evaluated against the current context, so you can confirm that a field is shown or hidden for the right reason.
- Bricks Builder element conditions: the conditions set on elements, popups and sections. ACFDebug resolves the dynamic tags in them to their live values, so instead of a tag name you see the exact value the condition is reading right now.
If a popup does not open or a section does not appear, you can check in seconds whether the condition is wrong or the data is.
Find the ACF data your site no longer uses
Over time every ACF project collects leftovers. Fields get renamed, groups get restructured, content gets deleted. The values stay behind in the database and nothing in WordPress tells you.
The Clean Orphans tool scans for them. It looks for ACF data whose field definition was deleted or renamed, data whose parent post, user or term no longer exists, and data that belongs to field groups that are inactive or cannot be reached by any location rule. Results are organised in tabs for posts and pages, the options page, user meta, terms and lost user data.
Each tab shows the object, the meta key, the field key and the reason the row was flagged. The post and page tab also shows the modified date, so you can judge how old the data is.
Catch unreferenced data with the extra check
Some leftovers have no reference row at all, which makes them hard to detect. An optional extra check includes this unconfirmed data in the results. These rows are clearly marked as unconfirmed, so you always know the difference between a confirmed orphan and a likely one before you delete anything.
Compare two users to find lost user data
Renamed fields often leave values behind in user profiles. The Lost User Data tool compares two users side by side and highlights the differences. When one user has fields the other does not, those fields are flagged as possible lost orphans. You can review them manually and delete only what you are sure about.
Stay in control of every deletion
Cleaning a database should never feel risky, so ACFDebug builds in several safeguards:
- A clear warning to back up your database before you delete anything.
- A required confirmation checkbox. The delete button stays disabled until you tick it.
- Row by row selection, with a select all option for each page of results.
- Search, per page settings and pagination, so you work through large result sets in manageable steps.
Nothing is removed automatically. You decide what goes.
Made for administrators only
The debug bar only appears for administrators, and only while ACFDebug is switched on. Visitors and other user roles never see it, even if you forget to turn it off. That makes it safe to use on live sites and client projects when you need to diagnose something in production.
A proper home in your WordPress menu
ACFDebug has its own top level menu item with a dedicated icon. It contains an Overview page and a Clean Orphans page, so the cleaner is one click away from the side menu.
The admin toolbar adds a quick toggle that shows whether the debugger is on or off. Its dropdown links straight to the Overview and Clean Orphans. You can switch the debugger on and off from any page of your site.
An overview page that explains itself
The Overview page shows the current status, the enable and disable button and a quick start guide. Below that is a full how to guide covering every feature. The same guide is available in a searchable Documentation window, with a navigation menu and live search results, so your team can find answers without leaving WordPress.
A clean interface in light and dark mode
The admin screens follow a consistent design with a clear header, tabs, tables and forms. A dark mode switch in the header changes the look instantly, and the choice is remembered for each administrator. The screens use the full width of your admin area, so wide tables stay readable.
Built-in changelog and updates
A Changelog window shows what changed in each version. A Check for updates button looks for a newer release. When one is available it shows up on the normal WordPress Plugins screen, where you update it like any other plugin.
Light on your site and tidy when removed
The debug bar loads only when it is enabled and only for administrators, so it has no effect on the experience of your visitors. If you ever uninstall ACFDebug, it removes its own settings and saved preferences and leaves nothing behind.
Who ACFDebug is for
ACFDebug is made for WordPress developers, agencies and site builders who rely on ACF and often work with Bricks Builder. It is useful when you:
- Build and test complex field structures, groups and repeaters.
- Troubleshoot conditions that do not behave as expected.
- Hand over a project and want a clean database.
- Take over an older site and need to understand what its fields are really doing.
- Support clients and need to see their data quickly.
Requirements
ACFDebug works with Advanced Custom Fields. Bricks Builder is optional and only needed if you want to inspect Bricks element conditions. Install it like any other plugin, switch it on, and open a page on your site.
Get it now.
License:
You can use this plugin on as many sites as you want, but future updates are not included.
Free
Other products