Run an ACF completeness audit

MaintenanceBeginner~10 min

Before you start

Advanced Custom Fields active and content reads on. The agent needs edit access to the posts it reads. No write ability required.

Before a directory, a catalog, or a team page goes live, the quiet worry is the half-finished entry: the profile with no photo, the product with a blank spec, the listing missing its one required line. ACF will happily let a post save with empty fields, so nothing warns you until a visitor finds the hole.

This is the check you run first. It reads the fields you care about across the posts you point it at and hands back a gap report, and it cannot change a thing.

The prompt
I want to know which of my [staff] profiles are missing required custom fields
before we publish the new directory. Read only, change nothing.
First show me the ACF field groups so we can agree on which fields count as
required: [role, headshot, and bio]. Then, for the post IDs I paste below, read
the ACF values on each one and build me a table with a row per post and a column
per required field, marking each cell filled or empty. Put the posts with the
most gaps at the top, and give me a one-line count of how many are complete
versus how many still need work.

Why this is safe to run

Both abilities behind this prompt are reads. Listing the field groups returns their structure only, never any stored value, and reading a post’s ACF values cannot write, so the worst case is that a field you left switched off quietly returns nothing. There is no write ability in the recipe at all, which is why it is safe to run again after every round of fixes to confirm the gaps are closing.

Already connected? Skip the paste. Ask your agent for the “ACF completeness audit” recipe, or just ask which posts are missing their custom fields, and it runs the same reads on your own install.

How it works

  1. List the ACF field groups so you can name which fields count as required.
  2. Read the ACF values on each post ID you provide.
  3. Build a table with a row per post and a column per required field, marking each cell filled or empty.
  4. Sort the posts with the most gaps to the top.
  5. Give a one-line count of how many posts are complete versus how many still need work.

Questions

Can this change or fill in any of the fields?
No. Every part of it is a read. It reports which fields are empty and writes nothing, so you can run it as often as you like before a launch.
How does it know which fields are required?
You tell it. ACF does not expose a hard required flag to read, so the prompt has you name the fields that matter, and the agent checks those against each post.