Elemental divider element

The divider element renders a horizontal rule between elements. Use it to separate content sections. The type value is "divider". When to use:

Separate distinct sections of content
Create visual breaks between related items
Improve readability in long notifications
Organize grouped content visually

Basic example

{
  "type": "divider",
  "color": "#800080"
}

const { requestId } = await client.send.message({
  message: {
    to: {
      email: "sarah@acme-corp.com",
    },
    content: {
      version: "2022-01-01",
      elements: [
        {
          type: "divider",
          color: "#800080",
        },
      ],
    },
  },
});

response = client.send.message(
    message={
      "to": {
        "email": "sarah@acme-corp.com",
      },
      "content": {
        "version": "2022-01-01",
        "elements": [
          {
            "type": "divider",
            "color": "#800080",
          },
        ],
      },
    },
)

curl -X POST https://api.courier.com/send \
  -H "Authorization: Bearer $COURIER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "message": {
        "to": {
          "email": "sarah@acme-corp.com"
        },
        "content": {
          "version": "2022-01-01",
          "elements": [
            {
              "type": "divider",
              "color": "#800080"
            }
          ]
        }
      }
    }'

response = courier.send_.message(
  message: {
    to: {
      email: "sarah@acme-corp.com"
    },
    content: {
      version: "2022-01-01",
      elements: [
        {
          type: "divider",
          color: "#800080"
        }
      ]
    }
  }
)

// Elemental nodes carry no typed content fields, so pass the document as raw JSON.
content := param.Override[shared.ElementalContentParam](json.RawMessage(`{
  "version": "2022-01-01",
  "elements": [
    {
      "type": "divider",
      "color": "#800080"
    }
  ]
}`))

response, err := client.Send.Message(context.TODO(), courier.SendMessageParams{
	Message: courier.SendMessageParamsMessage{
		To: courier.SendMessageParamsMessageToUnion{
			OfUserRecipient: &shared.UserRecipientParam{
				Email: courier.String("sarah@acme-corp.com"),
			},
		},
		Content: courier.SendMessageParamsMessageContentUnion{OfElementalContent: &content},
	},
})

SendMessageParams params = SendMessageParams.builder()
    .message(SendMessageParams.Message.builder()
        .to(JsonValue.from(java.util.Map.of("email", "sarah@acme-corp.com")))
        .content(JsonValue.from(java.util.Map.of(
                "version", "2022-01-01",
                "elements", java.util.List.of(
                  java.util.Map.of(
                    "type", "divider",
                    "color", "#800080")))))
        .build())
    .build();
SendMessageResponse response = client.send().message(params);

$response = $client->send->message(
  message: [
    'to' => [
      'email' => 'sarah@acme-corp.com',
    ],
    'content' => [
      'version' => '2022-01-01',
      'elements' => [
        [
          'type' => 'divider',
          'color' => '#800080',
        ],
      ],
    ],
  ],
);

// Elemental nodes expose no typed content fields, so build the document from raw JSON.
SendMessageParams parameters = new()
{
    Message = new()
    {
        To = new UserRecipient { Email = "sarah@acme-corp.com" },
        Content = ElementalContent.FromRawUnchecked(
            JsonSerializer.Deserialize<Dictionary<string, JsonElement>>("""
            {
              "version": "2022-01-01",
              "elements": [
                {
                  "type": "divider",
                  "color": "#800080"
                }
              ]
            }
            """)),
    },
};

var response = await client.Send.Message(parameters);

courier send message \
  --api-key "$COURIER_API_KEY" \
  --message.to '{"email": "sarah@acme-corp.com"}' \
  --message.content '{"version": "2022-01-01", "elements": [{"type": "divider", "color": "#800080"}]}'

With Courier MCP, send an email to sarah@acme-corp.com with a divider between two sections.

Fields

string

The CSS color of the divider line. Any valid CSS color value (e.g., "#e0e0e0", "rgb(224, 224, 224)", "gray"). Defaults to a standard gray.

string

Border width in pixels for the divider line (e.g., "1px", "2px").

string

Padding around the divider. Any valid CSS padding value (e.g., "10px", "20px 10px").

string[]

An array of channel names. The divider renders only for the listed channels. See .

Examples and variants Basic divider Simple divider with default styling:

{
  "type": "divider"
}

Styled divider Divider with custom color:

{
  "type": "divider",
  "color": "#800080"
}

Thick divider Divider with custom width:

{
  "type": "divider",
  "color": "#007bff",
  "border_width": "3px"
}

Divider with padding Divider with spacing:

{
  "type": "divider",
  "color": "#e0e0e0",
  "padding": "20px 0"
}

Section separator Using dividers to separate content sections:

{
  "version": "2022-01-01",
  "elements": [
    {
      "type": "text",
      "content": "Order Summary",
      "text_style": "h2"
    },
    {
      "type": "text",
      "content": "Item 1: $29.99"
    },
    {
      "type": "text",
      "content": "Item 2: $49.99"
    },
    {
      "type": "divider",
      "color": "#cccccc"
    },
    {
      "type": "text",
      "content": "Total: $79.98",
      "bold": true
    }
  ]
}

Channel support

Email: ✅ Full support with styling
Push: ⚠️ Limited support (may render as plain text or be ignored)
SMS: ❌ Not supported (dividers are not rendered)
Inbox: ✅ Full support with styling

Get started

Send messages

Journeys

Broadcasts

Design

Recipients

Tenants

Monitoring

Workspaces

Resources

Elemental divider element