Skip to main content

Field Group

PropertyValue
descriptionCollection of related custom fields assigned to WordPress objects through location rules.
tagsref

A field group is a collection of related custom fields that are displayed together in the editor.

The term is primarily used in the context of ACF.

In native WordPress terminology, a similar admin container is often discussed as a meta box.

What it does​

A field group lets you:

  • Organize multiple related fields together
  • Control where fields appear in the backend
  • Attach fields to specific content types or admin contexts
  • Build structured editing interfaces instead of loose ad hoc metadata

Core concepts​

Grouped fields​

A field group is the container. The individual custom fields inside it hold the actual data.

Location rules​

In ACF, field groups are usually assigned using location rules.

Those rules determine where the group appears, such as on a specific post type, taxonomy, user, or options page.

Output layer​

The field group controls the editing experience, but developers still decide how the field data is rendered in templates, builders, or PHP.

Common use cases​

  • Attaching structured fields to a post type
  • Attaching fields to a taxonomy term screen
  • Creating grouped settings for an options page
  • Building reusable editing patterns for a site section
  • Supporting ACF-driven content models in WordPress

Practical notes​

  • A field group should usually represent one coherent editing context.
  • Smaller, focused groups are often easier to maintain than one oversized group.
  • Good field naming inside a field group improves both editor clarity and developer output work.

Frequently Asked Questions​

Is a field group the same as a custom field?​

No. A field group contains multiple custom fields.

Can a field group be attached to more than one type of content?​

Yes. Depending on the rules, a group can be used across multiple editing contexts.

Is a field group the same as a meta box?​

Not exactly, but they are closely related. A meta box is the broader WordPress admin UI concept, while a field group is a more specific structured grouping term often used by ACF.

Why use field groups instead of loose metadata?​

Field groups create a more structured editing experience and make data modeling easier to reason about.