BotGhost Documentation
Support ServerYouTubeMarketplaceBotGhost PremiumSign in
  • Welcome to BotGhost
  • Guidelines & Privacy
  • Changelogs 2025
    • Changelogs 2024
    • Changelogs 2023
  • BotPanel Documentation
  • Getting Started
    • Create Your First Bot
      • Create Your Second Bot
    • Invite Your Bot
    • Standard Practices
      • Advanced Practices
    • Mobile Application (PWA)
  • Support
    • BotGhost Support
    • Frequently Asked Questions
  • Premium & Priority Hosting
    • Priority Hosting
    • Our Premium Features
    • Plans & Payment Methods
    • Manage Your Subscription
    • Upgrade Your Bot
    • Refund & Cancellation Policy
    • Beta Features
  • General Settings and Collaboration
    • Settings
    • Collab
    • Status
    • Active Developer Badge
    • Marketplace
  • Custom Commands & Events
    • Command & Event Builder
      • Sharing Commands and Events
      • Advanced Options
    • Actions
      • Message Actions
        • Send or Edit a Message
          • Button
          • Select Menu
        • Edit a Button or Select Menu
        • Send a Form
        • Delete a Message
        • Publish a Message
        • React to a Message
        • Pin a Message
      • Custom Variable Actions
        • Set Variable
        • Run Equation on Variable
        • Delete Variable
      • API Actions
        • Send an API Request
        • Execute an IFTTT Trigger
      • Loop Actions
        • Run a Loop
        • Stop a Loop
      • Voice Actions
        • Join a Voice Channel
        • Leave a Voice Channel
        • Voice Move a Member
        • Voice Kick a Member
        • Voice Mute or Unmute a Member
        • Voice Deafen or Undeafen a Member
      • Role Actions
        • Add Roles
        • Remove Roles
        • Create a role
        • Delete a role
        • Edit Role
      • Channel Actions
        • Create a channel
        • Edit a channel
        • Delete a channel
      • Thread and Forum Actions
        • Create a Thread
        • Edit a Thread
        • Delete a Thread
      • Server Actions
        • Kick a member
        • Ban a member
        • Timeout a member
        • Change a members nickname
        • Purge Messages
        • Create Server Invite
      • Other Actions
        • Wait before running another action
        • Manipulate some text
        • Send an error log message
        • Set a unique variable
        • Change the Bot's Status
        • Note
      • [LEGACY] Reply Actions
        • Plain Text Reply
        • Embed Reply
        • Random Reply
        • Send a message to a channel
        • Direct Message a User
        • Send a Message with attached buttons
          • Buttons
        • Send a message with a select menu
          • Menu Option
    • Conditions
      • Comparison Condition
      • Permission Condition
      • Chance Condition
      • Channel Condition
      • Role Condition
      • User Condition
      • Premium Check Condition
    • Options
      • Text Option
      • Number Option
      • User Option
      • Channel Option
      • Role Option
      • Choice Option
      • Attachment Option
    • Events
      • Timed Events
      • Webhooks
    • Data Storage
      • Collections
      • Objects
    • IFTTT
    • Variables
  • Server Management
    • Moderation
    • Discord Automod
    • Tickets
    • Welcomer
    • Verification
    • Statistic Channels
    • Modmail
    • Auto-React
    • Sticky Roles
    • Emoji Manager
    • Polls Filter
    • Automod
    • Logging
  • Messages
    • Timed Messages
    • Reaction Roles
    • Autoresponder
    • Embed Builder
    • Sticky Messages
    • Polls
    • Global Chat
    • Media Channels
  • AI
    • ChatGPT
    • Image Generation
  • Game Integrations
    • Roblox Verification
  • Social Integrations
    • YouTube
    • Twitch
  • Community Engagement
    • Leveling
    • Temp Voice Channels
    • Suggestions
    • Invite Tracker
    • Starboard
    • Question Of The Day
    • Giveaways
  • Fun Modules
    • Economy & Minigames
    • Birthdays
    • Counting
  • Utility
    • Translation
    • Weather
Powered by GitBook
On this page
  • Channel
  • Name
  • Topic
  • Category
  • Slowmode
  • NSFW
  • User Limit
  • Optional Server ID
  • Reason
  • Merge Permissions
  • Permissions
  • Enable Success/Error Handles

Was this helpful?

  1. Custom Commands & Events
  2. Actions
  3. Channel Actions

Edit a channel

Last updated 8 months ago

Was this helpful?

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.

Channel

This is the specific channel that the block will be targeting to edit.

Channel Option

Channel ID

Name

Topic

Warning: This only works for Text Channels

Category

Slowmode

Warning: This only works for Text Channels

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

Warning: This only works for Text Channels

User Limit

Warning: This only works for Voice Channels

Optional Server ID

Reason

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.

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

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.

Clicking on the User type will make the bot base the permissions off of a user.

User

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.

This selection will edit the channel that the command / event was executed in or where a / was clicked.

By selecting the 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 use Channel ID.

A must be added to the command for this selection to work.

This dropdown type will allow the bot to edit the channel with a specific channel ID or .

Input a plain channel ID into the field below. The ID must be plain and have no extra symbols or spaces. Likewise a can be used if it returns a plain channel ID.

This optional field modifies the name of the channel. It may be left blank to leave the name unedited. can be used.

This optional field modifies the topic of the channel. It may be left blank to leave the topic unedited. can be used.

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 can be used such as a .

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 can be used.

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 can be used.

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 / . 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. can be used as well.

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 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 from this dropdown.

In this field you can input a plain user ID or a that returns one. can also be used.

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 .

button
menu option
channel option
variables
channel option
variable
variable
Variables
Variables
variables
text option
variables
variables
button
menu option
Variables
Variables
link
role options
variable
User options
What the merge permission option looks like in the builder
here