Siblings

Siblings are fields that share the same structure. Unlike duplicating a field, which creates an independent copy, creating a sibling links the fields: when you edit the structure or validation rules of one sibling, all of its siblings change too.

To create one, open the field's actions menu (⋯) and choose Create Sibling. When a linked field is selected, its siblings show a link icon in the tree, and the configuration panel gets a Siblings tab. To add another sibling, choose Create Sibling on any of the linked fields.

Create a sibling and share one structure

To make a field independent again, click Detach on its Siblings tab. Changing the type of a linked field also detaches it. A detached field moves to the end of the tree.

JSON Schema Structure

The builder stores the shared structure once under $defs, and each sibling points to it with a $ref. The builder manages these definitions when you create or detach siblings.

{
  "$defs": {
    "address": {
      "type": "object",
      "properties": {
        "street": { "title": "Street", "type": "string" },
        "city": { "title": "City", "type": "string" }
      }
    }
  },
  "type": "object",
  "properties": {
    "shippingAddress": { "title": "Shipping Address", "$ref": "#/$defs/address" },
    "billingAddress": { "title": "Billing Address", "$ref": "#/$defs/address" }
  }
}