Separator

type: 14 Messages

The Separator adds space between components and, optionally, a divider line. It helps your message breathe and read better.

Preview

My BotAPPToday at 12:00 PM

Small separator with a line 👇

---

Large separator with a line 👇

---

Large separator without a line (just space) 👇

End of message.

payload.json

{
  "flags": 32768,
  "components": [
    {
      "type": 17,
      "components": [
        {
          "type": 10,
          "content": "Small separator **with a line** 👇"
        },
        {
          "type": 14,
          "divider": true,
          "spacing": 1
        },
        {
          "type": 10,
          "content": "Large separator **with a line** 👇"
        },
        {
          "type": 14,
          "divider": true,
          "spacing": 2
        },
        {
          "type": 10,
          "content": "Large separator **without a line** (just space) 👇"
        },
        {
          "type": 14,
          "divider": false,
          "spacing": 2
        },
        {
          "type": 10,
          "content": "End of message."
        }
      ]
    }
  ]
}

Fields

Field	Type	Description
type	integer	required Always 14.
id	integer	optional Unique identifier in the message.
divider	boolean	optional Show the line. Defaults to true.
spacing	integer	optional Space size: 1 = small, 2 = large. Defaults to 1.

Code

HTTP

{ "type": 14, "divider": true, "spacing": 2 }

JavaScript

import { SeparatorBuilder, SeparatorSpacingSize } from 'discord.js';

const small = new SeparatorBuilder(); // line + small space
const large = new SeparatorBuilder().setSpacing(SeparatorSpacingSize.Large);
const space = new SeparatorBuilder().setDivider(false).setSpacing(SeparatorSpacingSize.Large);

Python

small = discord.ui.Separator()  # line + small space
large = discord.ui.Separator(spacing=discord.SeparatorSpacing.large)
space = discord.ui.Separator(visible=False, spacing=discord.SeparatorSpacing.large)

Go

large := discordgo.SeparatorSpacingSizeLarge
noLine := false

small := discordgo.Separator{} // line + small space
big := discordgo.Separator{Spacing: &large}
space := discordgo.Separator{Divider: &noLine, Spacing: &large}

Tips

• Use the line to separate different topics and space only to add breathing room within the same topic.
• Don’t overdo it: every Separator counts toward the 40-component limit.