Custom fields (ACF)
When Advanced Custom Fields is active, a record’s custom fields become the fields object of the document. Reading a record exports the current field values, and writing sets them.
Requirements
Section titled “Requirements”ACF must be installed and active. The fields block that renders these values on the front-end needs ACF Pro.
How fields map
Section titled “How fields map”fields is a map of field name to value, mirroring the field group the theme defines.
- A group is a nested object.
- A repeater is a list of row objects, and you can add or remove rows freely.
- Flexible content is a list of sections, each tagged with
acf_fc_layout. You may only use layouts that already exist. - A simple field is a string, number or boolean.
Field names must match the definition exactly. An unknown key raises octa_unknown_field and is dropped, so the safest approach is to export a pattern record and change only the values.
Relations
Section titled “Relations”A relation field (post object or relationship) is written as a list of "{post_type}/{slug}" strings, which stay portable across installs.
"fields": { "related_offers": ["offer/service-5", "offer/service-7"] }The full field rules, including nested keys and warnings, live in Preparing JSON files.