How do I use Advanced Custom Fields's Register ACF Field Group ability with AI?

Install the Easy MCP AI WordPress plugin alongside Advanced Custom Fields, connect your AI client, then ask in natural language — for example: "Create a new ACF field group called "Book Details" with text fields for Author and ISBN that shows on the Book post type."

Register ACF Field Group is a WordPress ability from Advanced Custom Fields — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.

Install Free Plugin →

Register ACF Field Group

Write

Advanced Custom Fields Content & Tools acf/register-field-group

Create a new ACF field group with field definitions and location rules.

Requires Advanced Custom Fields (ACF) 6.8.0+ on a WordPress install where the Abilities API is available (native from WordPress 6.9, or via a compatible Abilities/Feature API polyfill). ACF's global 'Allow AI Access' setting (enable_acf_ai) must be turned on, and each individual field group, custom post type, or custom taxonomy must also have its own 'Allow AI Access' toggle enabled and be exposed in the REST API (show_in_rest) before its abilities are registered. Most abilities additionally require the current user to hold ACF's configured management capability (acf_get_setting('capability'), default manage_options) or the matching WordPress post-type/taxonomy capability (create_posts, edit_posts, delete_posts, manage_terms, edit_terms, delete_terms).

What it does

This ability registers a brand-new ACF field group, defining the field schema (text, number, select, relationship, and every other supported ACF field type) and the location rules that decide where the group appears in the WordPress admin. It only creates the field structure itself, not field values on individual content, so it's typically used before creating or updating posts, terms, or other items that will hold that data. On success it returns the full created field group, including its generated key and ID, ready to be referenced by other abilities. The operation is idempotent-safe from ACF's perspective (it always creates a fresh group with a unique key) but not destructive, since it never removes or overwrites existing groups.

See it in action

You ask your AI assistant

"Create a new ACF field group called "Book Details" with text fields for Author and ISBN that shows on the Book post type."

Inputs

Name	Type	Required	Description
title	string	Yes	The title of the field group.
fields	array	Yes	Array of field definitions to add to the field group; each item matches the field-type-specific creation schema for its ACF field type.
location	array	Yes	Location rules (OR groups of AND rules) determining where this field group appears in the admin.
description	string	No	A description for this field group.
position	string	No	Where to show the field group: normal, side, or acf_after_title.
style	string	No	Field group style: default or seamless.
label_placement	string	No	Where to place field labels: top or left.
instruction_placement	string	No	Where to show field instructions: label or field.
hide_on_screen	array	No	Edit-screen items to hide, e.g. permalink, the_content, excerpt, custom_fields, discussion, comments, revisions, slug, author, format, page_attributes, featured_image, categories, tags, send-trackbacks.
active	boolean	No	Whether the field group is active. Defaults to true.
show_in_rest	boolean	No	Whether the field group is shown in the REST API. Defaults to true.
allow_ai_access	boolean	No	Whether the field group itself allows AI access. Defaults to true.
ai_description	string	No	A short description to give AI systems more context about this field group.

Returns

An object with a success boolean, the full created field_group (ID, key, title, fields, location, and settings), the new field_group_id, and a confirmation message.