# Edit a channel
This action block will edit a existing channel in the server with new modifications or permissions. {% hint style="warning" %} Warning: The bot must have Manage Channels to be able to Edit a channel. {% endhint %} ## Channel This is the specific channel that the block will be targeting to edit.
{% tabs %} {% tab title="Channel the command was used in" %} This selection will edit the channel that the command / event was executed in or where 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) was clicked. {% endtab %} {% tab title="Channel Option" %} By selecting the [channel option](https://botghost.com/docs/custom-commands-and-events/options/channel-option) type, it will prompt to make a new field where you can input the channel option and the bot will edit that channel. Only channel options can be selected in this field, for IDs and [variables](https://botghost.com/docs/custom-commands-and-events/variables) use [#channel-id](#channel-id "mention"). ### Channel Option A [channel option](https://botghost.com/docs/custom-commands-and-events/options/channel-option) must be added to the command for this selection to work.
{% endtab %} {% tab title="Channel ID" %} This dropdown type will allow the bot to edit the channel with a specific channel ID or [variable](https://botghost.com/docs/custom-commands-and-events/variables). ### Channel ID Input a plain channel ID into the field below. The ID must be plain and have no extra symbols or spaces. Likewise a [variable](https://botghost.com/docs/custom-commands-and-events/variables) can be used if it returns a plain channel ID.
{% endtab %} {% endtabs %} ## Name This optional field modifies the name of the channel. It may be left blank to leave the name unedited. [Variables](https://botghost.com/docs/custom-commands-and-events/variables) can be used.
## Topic This optional field modifies the topic of the channel. It may be left blank to leave the topic unedited. [Variables](https://botghost.com/docs/custom-commands-and-events/variables) can be used. {% hint style="warning" %} Warning: This only works for Text Channels {% endhint %}
## Category This is an optional field that moves the channel to a different category. It may be left blank to leave the category unedited. This field only accepts plain category IDs or [variables](https://botghost.com/docs/custom-commands-and-events/variables) can be used such as a [text option](https://botghost.com/docs/custom-commands-and-events/options/text-option).
## Slowmode This is an optional field, also known as rate limit per user, it allows you to set a slow mode in the edited 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. {% hint style="warning" %} Warning: This only works for Text Channels {% endhint %}
## 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+. {% hint style="warning" %} Warning: This only works for Text Channels {% endhint %}
## 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. {% hint style="warning" %} Warning: This only works for Voice Channels {% endhint %}
## Optional Server ID This field is an optional server ID to search for the channel in. Leave blank to find 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.
## Reason This field is an optional reason of why the bot is editing this channel. This reason will appear in your server's Audit Log. [Variables ](https://botghost.com/docs/custom-commands-and-events/variables)can be used as well.
## Merge Permissions Instead of having your permissions overwritten when you edit a channel, you can merge the permissions you specify with the already existing permissions set in the channel.

What the merge permission option looks like in the builder

If you enable this option, the permissions you specify will be merged with the permissions that are already in the channel. It won't touch or edit any permissions that are not specified. If you leave this option disabled, the permissions in the channel will be overwritten with the permissions that you specify. ## Permissions 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](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).