---
title: Repeater field mapping
slug: content-marketing-platform/docs/repeater-field-mapping
docTags: 
createdAt: 2026-07-22T20:21:12.480Z
---

Optimizely Content Marketing Platform (CMP) supports mapping the ACF `Repeater` field to the structured content `Component` and `Reference` type fields.

Create the structured content component first, then add the appropriate fields.

## Example

You created a component called `ACF Repeater` with two text type fields, `Name` and `Address`.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/cInT1qj26Cu-FZ-8j3-oX_91c796690ca9e0b29356e73ad94e3f72e15d71aed031e982e1545d1dbf4eebce-image.png)

Add this `Component` to the structured content as a `Reference` field.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/fUF09p4pbBAD7atQRGAvS_5bc93cfa1d5101be4c4698619f0987c5492455d8499ed07719e0d06cdd46816f-image.png)

:::hint{type="info"}
**📘 Note**
Toggle **Allow multiple entries** to **On**.
:::

**JSON example to create the component**

```json
{
  "details": {
    "name": "ACF Repeater",
    "component": true,
    "disabled": false
  },
  "source": "wordpress",
  "source_id": null,
  "source_metadatata": null,
  "created_by": "<user_guid>",
  "field_definitions": [
    {
      "core": {
        "key": "name",
        "name": "Name",
        "is_list": false,
        "is_required": false,
        "need_internationalization": false,
        "min_list_length": 1,
        "max_list_length": -1,  // no max length limit
        "field_type": "text-field",
        "source_id": null,
        "source_metadata": "{\"is_custom_post_type_field\": true}",  // It is important to identify source_metadata as custom field
        "order_index": 0,
        "help_text": null,
        "editor_metadata": null
      },
      "validation_pattern": ".*",  // Validation required. Here it will accept anything but we can define our own validation
      "min_length": 0,
      "max_length": -1,  // no max length limit
      "default_values": null
    },
    {
      "core": {
        "key": "address",
        "name": "Address",
        "is_list": false,
        "is_required": false,
        "need_internationalization": false,
        "min_list_length": 1,
        "max_list_length": -1,  // no max length limit
        "field_type": "text-field",
        "source_id": null,
        "source_metadatata": "{\"is_custom_post_type_field\": true}",  // It is important to identify source_metadata as custom field
        "order_index": 1,
        "help_text": null,
        "editor_metadata": null
      },
      "validation_pattern": ".*",  // Validation required. Here it will accept anything but we can define our own validation
      "min_length": 0,
      "max_length": -1,  // no max length limit
      "default_values": null
    }
  ]
}
```

**JSON example to add a reference field**

```json
{
  "core": {
    "key": "acf_repeater_field",
    "name": "ACF Repeater Field",
    "is_list": true,
    "is_required": false,
    "need_internationalization": false,
    "min_list_length": 1,
    "max_list_length": -1,
    "field_type": "content-type",
    "source_id": null,
    "source_metadata": "{\"is_custom_post_type_field\": true, \"type\": \"repeater\"}",  // It is important to identify source_metadata as custom field and also add type as repeater
    "order_index": 0,
    "help_text": null,
    "editor_metadata": null
  },
  "allowed_content_types": ["<repeater_component_guid>"],
  "ref_type": 3,  // 3 Means it will create new every time
  "allow_ref_edit": false,
  "default_value": null
}
```