Create a channel
Last updated
Last updated
The Create a channel action when triggered creates a channel of any type within a Discord server. It can be referenced in any action or condition throughout your bot's commands and events. All variables and options can be used in the content of all fields within the block.
The create a channel block also comes with a variable that can be used in later actions or saved in custom variables. This variable can be found at the top of the settings of the block. Here is an example of how it can be used.
{channel_id[option_created_channel_abcd]}
This variable will return the ID of the channel. Make sure to replace abcd with the actual 4 unique characters.
{option_created_channel_abcd}
This variable will return the channel mention. Make sure to replace abcd with the actual 4 unique characters.
The name of the channel is what's displayed in the channel list, the top of the channel, and any references of the channel.
Name is not compatible with markdown.
The type of channel defines its function and appearance. You can select from a dropdown that will display the available channel types. Below you can find detailed information about each channel type and how it can be used.
A text channel is a basic channel for Discord users to have text conversations with other server members.
This is an optional toggle to choose whether or not to allow NSFW content within the channel. If chosen, the channel will be age restricted to 18+.
This is an optional field, also known as rate limit per user, it allows you to set a slow mode in the created channel for each user unless the user has been bypassed. This field only accepts integers, and variables can be used.
This optional field modifies the topic of the channel. It may be left blank to leave the topic blank. Variables can be used.
Here you can set the ID of the category the channel you're creating is in. You can do this by pasting an ID directly from Discord (learn how here) or using a variable that returns a category ID. These can be easily added through the variable selector by clicking the Clipboard button. You can also leave this field empty to create the channel above all categories.
This field is an optional server ID to create the channel in. Leave blank to create the channel in the server the command was triggered in or who clicked a button / menu option. Variables can be used in this field and it must be a plain server ID that is returned.
Click the "+" to attach one or more permissions to the channel the bot is editing. Leave this field blank to have default permissions. Visit this link to learn more about permissions. Clicking the button below will allow you to add permissions to the channel.
Selecting this dropdown type will make this permission based off a role. Once selected a new field will appear for you to be able to choose which role from your server to base the permissions off of. You are also able to select role options from this dropdown.
If your role isn't showing, it was most likely recently added. Click the refresh icon to refresh the list of roles to find the role you want.
Enable Success / Error Handles to detect success and errors inside of the action block. This allows you to run different actions if something goes wrong with your action. Inside of the handle, there are 2 different paths which are used to detect the outcome of the action. The green path on the bottom left side of the block indicates success, while the red path on the bottom right side of the block indicates error. You may attach action blocks to each side of the handle to get the outcome of your action block.
The Success/Error Handles feature includes 3 different error variables you can use to get information on why the action block encountered an error. Check them out here.
