Skip to content

loop-value

An inline atom that references a property from the current rc-loop iteration item and is replaced with its value at render time.

Attributes

AttributeDefaultConstraintExampleDescription
originalstring"orders.item_name"Authoritative source token in "value.index" form. Used for re-parsing.
valuestring"orders"The loop collection name (matches the loop-value attribute on the enclosing rc-loop).
indexstring"item_name"The property name on the iteration item to render.

Children

None (inline atom, leaf node).

Parent nodes

  • paragraph

Available in

  • Full Email RFM (rc-text, rc-heading)

JSON

json
{
  "type": "loop-value",
  "attrs": {
    "original": "orders.item_name",
    "value": "orders",
    "index": "item_name"
  }
}

In context — a paragraph inside an rc-loop that renders each order's item name:

json
{
  "type": "paragraph",
  "content": [
    { "type": "text", "text": "Product: " },
    {
      "type": "loop-value",
      "attrs": {
        "original": "orders.item_name",
        "value": "orders",
        "index": "item_name"
      }
    }
  ]
}

Email RFM syntax

Loop values are written as leaf directives using ::loop-value{…}:

Product: ::loop-value{original="orders.item_name" value="orders" index="item_name"}

The original attribute is the canonical identifier — the parser uses it on re-parse to reconstruct value and index. Always set original to "<value>.<index>".