# Create a channel

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. ## Variable The create a channel block also comes with an optional [variable](https://botghost.com/docs/custom-commands-and-events/variables) that can be used in later actions or saved in custom variables. This variable can be set at the top of the block's settings menu. Here is an example of how it can be used.

Variable	Usage
`{my_channel}`	This variable will return the ID of the channel.
`<#{my_channel}>`	This variable will return the channel mention.

## Name The name of the channel is what's displayed in the channel list, the top of the channel, and any references of the channel. {% hint style="info" %} Name is not compatible with markdown. {% endhint %}

## Type 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.

{% tabs %} {% tab title="Text Channel" %} A text channel is a basic channel for Discord users to have text conversations with other server members.

### NSFW 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+.

### Slowmode 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](https://botghost.com/docs/custom-commands-and-events/variables) can be used.

{% endtab %} {% tab title="Voice Channel" %} A voice channel is a interactive channel based of listening and speaking to other users.

### User limit This field represents an optional user limit targeting voice channels only. With a limit in place, only a certain amount of users can be in the voice channel. This field accepts integers only and [variables](https://botghost.com/docs/custom-commands-and-events/variables) can be used.

{% endtab %} {% tab title="Category Channel" %} The Category Channel is a Category that will be made when this type is selected. Categories can have multiple channels under them and sync permissions as well.

{% endtab %} {% tab title="News Channel" %} A News Channel is a announcement channel that can you publish messages from to followed servers.

{% endtab %} {% endtabs %} ## Topic This optional field modifies the topic of the channel. It may be left blank to leave the topic blank. [Variables](https://botghost.com/docs/custom-commands-and-events/variables) can be used.

## Category 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](https://support.discord.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID)) 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.

## Optional Server ID 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](https://botghost.com/docs/custom-commands-and-events/actions/legacy-reply-actions/send-a-message-with-attached-buttons/buttons) / [menu option](https://botghost.com/docs/custom-commands-and-events/actions/legacy-reply-actions/send-a-message-with-a-select-menu/menu-option). [Variables ](https://botghost.com/docs/custom-commands-and-events/variables)can be used in this field and it must be a plain server ID that is returned.

## Permissions Click the "+" to attach one or more permissions to the channel the bot is creating. Leave this field blank to have default permissions. Visit this [link](https://discord.com/developers/docs/topics/permissions#permissions-bitwise-permission-flags) to learn more about permissions. Clicking the button below will allow you to add permissions to the channel.

{% tabs %} {% tab title="Role" %} 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](https://botghost.com/docs/custom-commands-and-events/options/role-option) 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. {% endtab %} {% tab title="User" %} Clicking on the User type will make the bot base the permissions off of a user. ### User In this field you can input a plain user ID or a [variable](https://botghost.com/docs/custom-commands-and-events/variables) that returns one. [User options](https://botghost.com/docs/custom-commands-and-events/options/user-option) can also be used.

{% endtab %} {% endtabs %} ## Enable Success/Error Handles 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](https://botghost.com/docs/variables#error-variables).