wp acf json status

Documentation wp acf json status

Last updated Mar 30, 2026

Overview

Shows the sync status for ACF item types (field groups, post types, taxonomies, options pages).

Description

Displays how many items are pending sync. Items are considered “pending” when the JSON file is newer than the database entry, or when the item exists in JSON but not in the database.

Options

wp acf json status [--type=<type>] [--detailed] [--format=<format>]

--type=<type> (string) Optional. Limit to a specific item type. Defaults to all item types (field groups, post types, taxonomies, options pages). – field-group – post-type – taxonomy – options-page (ACF PRO only)

--detailed (flag) Optional. Show detailed list of modified items instead of just counts.

--format=<format> (string) Optional. Output format. Default: table – table – json – yaml – csv

Examples

Check all item types

$ wp acf json status
+---------------+---------+-------+----------------+
| Type          | Pending | Total | Status         |
+---------------+---------+-------+----------------+
| field-group   | 3       | 12    | Sync available |
| post-type     | 0       | 2     | In sync        |
| taxonomy      | 1       | 3     | Sync available |
| options-page  | 0       | 1     | In sync        |
+---------------+---------+-------+----------------+
4 item(s) pending sync. Run wp acf json sync to apply changes.

Check only field groups

$ wp acf json status --type=field-group

Show detailed list of pending items

$ wp acf json status --detailed
+-------------------+------------------+---------------+--------+
| Key               | Title            | Type          | Action |
+-------------------+------------------+---------------+--------+
| group_abc123      | Product Fields   | field-group   | Update |
| group_def456      | Homepage         | field-group   | Create |
| taxonomy_ghi789   | Product Category | taxonomy      | Update |
+-------------------+------------------+---------------+--------+

Output status as JSON for scripts

$ wp acf json status --format=json
[{"Type":"field-group","Pending":3,"Total":12,"Status":"Sync available"}]

CI/CD pipeline check

# Check if sync is needed before deployment
$ wp acf json status --format=json | jq '.[] | select(.Pending > 0)'

Notes

• The status command is read-only and does not modify your database
• Use this command to verify sync state before running wp acf json sync
• Options pages require ACF PRO

Related

• CLI: wp acf json sync
• CLI: wp acf json export
• CLI: wp acf json import
• CLI: wp acf json
• Features: Local JSON