<div className="mb-4 bg-discord-red/20 p-2 rounded border border-discord-red font-medium flex gap-2 items-center"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" className="w-6 h-6 flex-shrink-0" ><path fillRule="evenodd" d="M8.485 2.495c.673-1.167 2.357-1.167 3.03 0l6.28 10.875c.673 1.167-.17 2.625-1.516 2.625H3.72c-1.347 0-2.189-1.458-1.515-2.625L8.485 2.495zM10 5a.75.75 0 01.75.75v3.5a.75.75 0 01-1.5 0v-3.5A.75.75 0 0110 5zm0 9a1 1 0 100-2 1 1 0 000 2z" clipRule="evenodd" /></svg><p>This feature is only avaliable to some users.</p></div>

There comes a time when you need to restrict who can run a command or click a button. Well with Button Bot you can do that! Simply you use permissions to restrict a command or button to a specific role, channel or person.

# Where to add permissions?

Well as of now there are 2 places where permissions can be used:


-   On a command.
-   On an action.


To add permissions on a command go to create command page and locate the permissions section below name.

![Command Permissions Bar](https://reoijqrtmfqpeaavlhql.supabase.co/storage/v1/object/public/support-images/permissions/command-permissions.png)

To add permission on an action go to the create command page open a message start to create an button and when you get to the button config section create an action and locate the bar at the top.

![Action Permissions Bar](https://reoijqrtmfqpeaavlhql.supabase.co/storage/v1/object/public/support-images/permissions/action-permissions.png)

# How to add a permission?

To start you can click on the plus icon within the bar. This will open up a popup with a few sections.

-   Roles (Permissions to limit access to discord roles)
-   Channels (Permissions to limit access to discord channels)
-   Misc (Other permissions that do not fit into a group)

## Roles

Restrict permissions to multiple discord roles.

![Roles Section](https://reoijqrtmfqpeaavlhql.supabase.co/storage/v1/object/public/support-images/permissions/roles-section.png)

If you desire to only allow your users with a @Gaming role to be able to use your Button Bot command then you can easily do that by clicking on the roles section, making sure the mode is on allow and then clicking the @Gaming role below. This will make it appear within the bar above and you can click to remove it.

If you do not want anyone with the @Muted role to be able to run your command then open the roles section select the deny mode and click on the @Deny role below. This will stop anyone with the @Deny role from using the command.

## Channels

Restrict permissions to multiple discord channels.

![Channels Section](https://reoijqrtmfqpeaavlhql.supabase.co/storage/v1/object/public/support-images/permissions/channels-section.png)

With channels you can limit users from only using commands in #bot-spam or any other channel. To do this select the channels section set the mode to allow and click on the #bot-spam channel below. This will restrict people from using the command anywhere else.

If you want the command to be ran everywhere except the #general channel then go to the channels section select the deny mode and click on the #general channel below. This will stop people from using the command in #general.

## Misc

Other types of permissions.

![Misc Section](https://reoijqrtmfqpeaavlhql.supabase.co/storage/v1/object/public/support-images/permissions/misc-section.png)

### Only Initial User

If you have a command that people use and you only want the person who sent the command to be able to click the buttons on in then you can use the 'Only Initial User' permission to achieve this.

Simply add the permission to your action and that action will only run if the user who click the button is the same user who ran the command in the first place.

# Combining permissions.

Using this permissions system you can combine up to 5 permissions per command/action. This means you can have people with the @Gaming role message in #general but not in #bot-spam where as you can have users with the @Muted role not be able to click a button at all.

### If you need any help with permissions please join our discord support server.

Need to restrict commands or actions to certain roles or channels permissions can help!

How to add permissions to Button Bot.

<div className="mb-4  bg-discord-red/20 p-2 rounded border border-discord-red font-medium flex gap-2 items-center"> <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" fill="currentColor" className="w-6 h-6 flex-shrink-0" > <path fillRule="evenodd" d="M8.485 2.495c.673-1.167 2.357-1.167 3.03 0l6.28 10.875c.673 1.167-.17 2.625-1.516 2.625H3.72c-1.347 0-2.189-1.458-1.515-2.625L8.485 2.495zM10 5a.75.75 0 01.75.75v3.5a.75.75 0 01-1.5 0v-3.5A.75.75 0 0110 5zm0 9a1 1 0 100-2 1 1 0 000 2z" clipRule="evenodd" /> </svg> <p> As of <time>26 November 2022</time> you can no longer transfer commands from the legacy version of Button Bot. </p> </div>

When we updated Button Bot we didn't want users to have to feel the need to recreate all their messages within the dashboard, so we looked for solutions. The issue is that the newer version of Button Bot handles commands differently. Each command can have multiple messages and buttons can only work within the current command (they can't edit/send other messages from outside the scope of the current command). The older version consisted of only one message per command and you could edit/send each message made. So we came up with the solution to transfer one or multiple messages from the legacy version of Button Bot to a new command in the newer version. This comes with some drawbacks the main one being we can't transfer buttons to new version. So how can you transfer messages?

# How to transfer messages...
## Step 1 - Locate Transfer Page

On the Button Bot dashboard select the server that you want to transfer existing messages to. Navigate using the sidebar to the Commands page. If you have created messages before transferring your existing messages, click on the blue tooltip text otherwise click continue on the transfer card.

![Transfer Page Location](https://reoijqrtmfqpeaavlhql.supabase.co/storage/v1/object/public/support-images/transfer-messages/page-location.png)

## Step 2 - Select Existing Messages

Select the existing messages that you want to be included in your new command. These messages will be imported from the legacy version of Button Bot and used as an template for a new command.

![Message Selection](https://reoijqrtmfqpeaavlhql.supabase.co/storage/v1/object/public/support-images/transfer-messages/transfer-messages.png)

## Step 3 - Fill Required Fields & Add Buttons

Make sure all required fields (name...) are filled so that you can create the command. Due to buttons not being transferred this is the part where you can add them again. You can find the button creator within each message dropdown. You can edit the command later.

After you have edited the command to your liking you can click the green create button at the bottom.

## Step 4 - Send in Discord

All messages that were sent before the update will no longer work, so you will need to run the command within discord again. This will update the message to be inline with the new update.

# Finally...

If you have any issues feel free to join our support server for help!

Learn how to transfer your existing messages from the legacy version of Button Bot.

Easily createinteractive buttons.

Button Bot BOT — Today at 14:34

Style your commands however you want

vers#8317

UCDFiddes#2808

Useful Resources and Support

How to add permissions to Button Bot.

How to transfer existing messages.