wordpress-acf-json-setup

Set up ACF PRO JSON synchronization for WordPress themes with save and load filters.

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/hifisaputra/wordpress-skills --skill wordpress-acf-json-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wordpress-acf-json-setup
Source: https://github.com/hifisaputra/wordpress-skills/tree/main/wordpress-acf-json-setup
Command: npx skills add https://github.com/hifisaputra/wordpress-skills --skill wordpress-acf-json-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Managing ACF data across WordPress themes is difficult without a version-controlled export. This skill creates a reliable acf-json folder tree and wires the necessary WordPress filters so field groups, CPTs, and taxonomies are saved to and loaded from JSON automatically, enabling clean Git diffs and reproducible builds.

Core Features & Use Cases

  • Create acf-json/ alongside the theme with subfolders for field groups, post types, and taxonomies.
  • Wire acf/save and acf/load filters to persist data to disk automatically and load it on theme initialization.
  • Provide a Tools → Export ACF to JSON admin page to re-save everything from the DB to JSON in one click.
  • Use when bootstrapping a new WordPress theme that uses ACF PRO or when migrating an existing theme’s ACF setup to version control.

Quick Start

Go to Tools → Export ACF to JSON and click Export now to populate the acf-json folder with all field groups, post types, and taxonomies.

Frequently Asked Questions about wordpress-acf-json-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I version-control ACF field groups in a WordPress theme?

You version-control ACF field groups by saving them as JSON files in an acf-json folder within your theme, which allows Git to track clean diffs and reproduce builds across environments.

How does ACF JSON synchronization work for custom post types and taxonomies?

ACF JSON synchronization works by wiring save_json and load_json filters to automatically persist custom post types, taxonomies, and field groups to disk and load them on theme initialization.

Can I automatically export ACF fields from the database to JSON in WordPress?

Yes, you can export ACF fields from the database to JSON by adding a custom Tools admin page that re-saves all DB content to the acf-json folder in one click.

What is the best way to bootstrap a new WordPress theme with ACF PRO?

The best way to bootstrap a WordPress theme with ACF PRO is to create an acf-json folder tree for field groups, post types, and taxonomies, and wire the necessary save and load filters for automatic synchronization.

Do I need ACF PRO to use JSON export for my WordPress theme?

You need ACF PRO to use this JSON export setup, because synchronizing custom post types and taxonomies via the acf-json folder requires the PRO version's features.

Why should I migrate my existing WordPress theme's ACF setup to version control?

Migrate your existing theme's ACF setup to version control to eliminate manual database exports, ensure reproducible builds, and maintain clean Git diffs for all field group changes.