bricks_create_acf_field_group

bricks_create_acf_field_group({
  title: "Hero Settings",
  fields: [
    { name: "hero_title", type: "text", label: "Hero Title", required: true },
    { name: "hero_background", type: "image", label: "Background Image", return_format: "array" },
    { name: "hero_cta_text", type: "text", label: "CTA Button Text", default_value: "Get Started" },
    { name: "hero_cta_link", type: "url", label: "CTA Link" }
  ],
  location_rules: [
    { param: "post_type", operator: "==", value: "page" }
  ],
  position: "acf_after_title"
})

bricks_create_acf_field_group({
  title: "Service Features",
  fields: [
    {
      name: "features",
      type: "repeater",
      label: "Features",
      sub_fields: [
        { name: "icon", type: "text", label: "Icon Class" },
        { name: "title", type: "text", label: "Feature Title" },
        { name: "description", type: "textarea", label: "Description" }
      ]
    }
  ],
  location_rules: [
    { param: "post_type", operator: "==", value: "service" }
  ]
})

Tip: After creating a field group, use bricks_create_post to populate content in the custom post type, including ACF field values via the meta parameter.

Tip: For repeater fields used with Bricks query loops, set the return_format of sub-fields appropriately. Image sub-fields should use « array » or « url » format for compatibility with Bricks dynamic data tags.

Warning: Known parameter mismatch: the TypeScript tool sends location_rules but the PHP endpoint expects location. The tool handles this transformation internally, but if you see fields appearing on the wrong post types, check the generated PHP file in {child-theme}/bricks-mcp/.

Warning: ACF Pro is required. The free version of ACF does not support repeater, group, or gallery field types.