Replicator Fieldtype

The Replicator is a meta fieldtype giving you the ability to define sets of fields that you can dynamically piece together in whatever order and arrangement you imagine. You can build long-form articles like and take advantage of the extra markup control.

It's so much better than a WYSIWYG field.

Behold! The Replicator Fieldtype!


You will be presented with a button for each set you’ve defined. Clicking one will replicate an empty set. You can replicate a single set type as many times as you like as well as dragging and dropping them to adjust their order.

You may collapse your sets to conserve space. If you do, a preview of the data contained within it will be displayed. Third party fieldtypes may control how their data will be previewed. You can prevent certain fields being shown in the preview text by adding replicator_preview: false.

The following fieldset YAML is an example of what could be used to construct the Replicator shown in the screenshot above:

    type: replicator
    display: Replicator
        display: Text
            type: markdown
        display: Image
            type: assets
            container: main
            max_files: 1
            type: text
        display: Pull Quote
            type: text
            type: text
            type: radio
              left: Left Align
              right: Right Align


You can use any fieldtypes inside your Replicator sets. Make sure to compare the experience with the other meta-fields: Grid and Bard.

Data Structure

Replicator stores your data as an array with the set name as type.

    type: text
    text: "Let's talk about the best new show from 2017!"
    type: image
    photo: /assets/night-manager.jpg
    caption: The Night Manager
    type: quote
    text: Such fear, such dread, and such a dazzling script.
    cite: Deborah Ross
    pull: right

Please note that you can not use a Replicator fieldtype for the content field.


Use the tag pair syntax with an if/else conditions to style each set accordingly.

{{ my_replicator_field }}

  {{ if type == "text" }}

    <div class="text">
      {{ text|markdown }}

  {{ elseif type == "quote" }}

    <blockquote>{{ text }}</blockquote>
    <p>— {{ cite }}</p>

  {{ elseif type == "image" }}

      <img src="{{ photo }}" alt="{{ caption }}" />
      <figcaption>{{ caption }}</figcaption>

  {{ /if }}

{{ /my_replicator_field }}

An alternative, and often cleaner, approach is to have multiple ‘set’ partials and do:

{{ my_replicator_field }}
  {{ partial src="sets/{type}" }}
{{ /my_replicator_field }}

Then inside your partials directory you could have:

sets/image.antlers.html sets/quote.antlers.html

and the set partial may look something like:

{{# this is image.antlers.html #}}

<img src="{{ image }}" alt="{{ caption }}" >

sets array

An array containing sets of fields.

max_sets integer

The maximum number of sets that may be added.

Betterify this page on Github!