Edit a channel
Last updated
Last updated
This action block will edit a existing channel in the server with new modifications or permissions.
Warning: The bot must have Manage Channels to be able to Edit a channel.
This is the specific channel that the block will be targeting to edit.
This selection will edit the channel that the command / event was executed in or where a button / menu option was clicked.
This optional field modifies the name of the channel. It may be left blank to leave the name unedited. Variables can be used.
This optional field modifies the topic of the channel. It may be left blank to leave the topic unedited. Variables can be used.
Warning: This only works for Text Channels
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 can be used such as a text option.
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 can be used.
Warning: This only works for Text Channels
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+.
Warning: This only works for Text Channels
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 can be used.
Warning: This only works for Voice Channels
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 / menu option. Variables can be used in this field and it must be a plain server ID that is returned.
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 can be used as well.
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.
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.
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.
