Skip to main content

Channel

{channel.mention;channel}​

Returns a string with a channel mention.

{channel.id;channel}​

Returns the ID of a channel.

{channel.type;channel}​

Returns an integer for the channel type.

{channel.createdAt;channel}​

Returns a timestamp for the creation date of a channel that can be used with {time}.

{channel.nsfw;channel}​

Checks if a channel is marked as NSFW.

{channel.name;channel}​

Returns the name of a channel.

{channel.lastMessageId;channel}​

Returns the ID of the last message sent in a channel.

{channel.topic;channel}​

Returns a channel topic, also known as channel description.

{channel.parentId}​

Get the parent ID of the channel. For regular channels this is the category ID. For threads this is the ID of the parent channel.

{channel.parentId} // "", a channel with no parent
{channel.parentId} // "532902705404837888", a regular channel with a parent
{channel.parentId} // "532902728834351115", a thread channel with a parent

{channel.isThread}​

Returns true if the channel is a thread.

{channel.isVoice}​

Returns true if the channel is a voice channel.

{channel.isTextable}​

Returns true if the channel can accept messages.

{channel.edit name? topic? nsfw? archived? ratelimit? parent?;channel}​

Updates a channel.

Arguments​

  • name: The new name of the channel.
  • topic: The new topic of the channel.
  • nsfw: Whether the channel is NSFW or not.
  • archived: Whether this channel is archived; channel must be a thread.
  • ratelimit: How often users can send messages in this channel, for example 1m.
  • parent: The category to move the channel to.

{channel.startThread auto_archive_duration? ratelimit? invitable? is_private? return_id? channel?;name;message?}​

Creates a new thread.

  • name the name of the thread.
  • message the message the thread is created from.
  • auto_archive_duration the time until threads are archived after inactivity. Can be one_hour, one_day, three_days or one_week.
  • ratelimit how often users can send messages in the thread, for example 1m.
  • invitable whether non-moderators can add other non-moderators to the thread; only available on private threads.
  • is_private whether the read is private, must not have a message to be private.
  • return_id whether to return the ID of the created thread.
  • channel the channel to create the thread on.

{channel.create name type topic nsfw parent return_id;channel}​

Creates a new channel.

Arguments​

  • name: The name of the channel.
  • type: The type of the channel. guildtext, guild_text, GUILD_TEXT, and GuildText are all valid and will all resolve to a guild text channel. IDs are also supported but the name is preferred.
  • topic: The topic of the channel.
  • nsfw: Whether the channel is NSFW or not.
  • parent: The parent channel, if any.
  • return_id: Whether to return the created channels ID or not.

{channel.delete;channel}​

This tag can do serious damage if you are not extremely careful with validating inputs. {.is-warning}

Deletes a channel.