ACF blocks are declared in PHP, not stored in the database, so there is no admin screen listing them all with their field bindings. Finding out what a site actually has usually means reading theme code.
blocks/list-acf-blocks answers it in one call: every registered ACF block, with its name, title, category, the field groups bound to it and how many fields those hold.
At a glance
| Ability | blocks/list-acf-blocks |
| Toolset | Advanced Custom Fields — toolset/acf |
| Group | ACF Blocks |
| Requires | Advanced Custom Fields Pro |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
This is the orientation call. Before registering a new block you want to know the name is free; before inserting one you want to know it exists and what it is called.
Block names are reported with their acf/ prefix. Every other ability in this group accepts the name with or without it.
The field-group counts tell you which blocks are backed by real fields and which are purely presentational — a block with no bound group takes no data payload.
Input
This ability takes no input.
What comes back
| Name | Type | What it is |
|---|---|---|
blocks | array | One entry per registered ACF block: name, title, category, bound field groups and field count. |
count | integer | How many blocks are registered. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Which ACF blocks does this site have, and which of them have fields behind them?
It resolves to one call:
{
"ability": "blocks/list-acf-blocks",
"parameters": {}
}Worth knowing
- Read-only and cheap. It is the right first call in any ACF block workflow.
- Blocks registered by a plugin or theme on a conditional hook only appear when that condition holds — the list reflects this request, not a stored catalogue.
- Requires ACF Pro. ACF blocks are a Pro feature.
Related abilities
- Get ACF Block Fields — the fields behind one of them
- Register ACF Block — check a name is free before taking it
- Insert ACF Block — put one into a post
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category