Skip to main content
Documentation/Integrations/Custom Fields/Advanced Custom Fields
Integrations

Advanced Custom Fields

Oxygen has built-in support for Advanced Custom Fields.
There's nothing to install, connect or configure: if ACF is active, your fields show up in
Oxygen's dynamic data chooser under an ACF category, grouped by the ACF field group they
belong to.

From there they behave like any other dynamic field. Click the dynamic data button on a
control — a heading's text, an image's source, a link's URL — open ACF, and pick the
field. The page then renders each post's own value.

The Insert Dynamic Data dialog with the ACF category open, fields grouped by the ACF field group they belong to

The integration covers the field types you'd expect (text, image, file, URL, gallery, date,
relationship, and more), plus the two structures that need more than a single value:

  • Repeater fields drive Oxygen's Repeater Field element, so a row of the repeater becomes
    a row of elements on the page.
  • Relationship and post object fields can be used as the query for a loop, so a loop
    outputs exactly the posts selected on the current post.

Both Free and Pro versions of ACF work; repeaters and flexible content are ACF Pro features,
so those parts follow whatever ACF itself gives you.

Where the details are

This page is the integration summary. The full reference — which ACF field type registers
which kind of dynamic field, how repeaters nest, and how to drive a loop from a relationship
field — is in the Dynamic Data section:

Troubleshooting

The ACF category isn't in the chooser

ACF has to be active, and it has to have at least one field group registered. Oxygen reads
ACF's field definitions — with no field groups there's nothing to list.

A field I created isn't offered on this control

The chooser only shows fields the control can accept: binding an image source offers
image-shaped fields, binding a text control offers text-shaped ones. Open the chooser from
the control that needs the value rather than picking the field first.