Discord.js Guide

Slash command permissions

Slash commands have their own permissions system, which allows you to control who has access to use which commands. Unlike the slash commands permission setting within the Discord client, you can fine-tune access to commands without preventing the selected user or role from using all commands.

TIP

If you set defaultPermission: false when creating a command, you can immediately disable it for everyone, including guild administrators and yourself.

User permissions

To begin, fetch an ApplicationCommand and then set the permissions using the ApplicationCommandPermissionsManager#add() method:

client.on('messageCreate', async message => {
	if (!client.application?.owner) await client.application?.fetch();

	if (message.content.toLowerCase() === '!perms' && message.author.id === client.application?.owner.id) {
		const command = await client.guilds.cache.get('123456789012345678')?.commands.fetch('876543210987654321');

		const permissions = [
			{
				id: '224617799434108928',
				type: 'USER',
				permission: false,
			},
		];

		await command.permissions.add({ permissions });
	}
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

Now you have successfully denied the user whose id you used access to this application command. If you have a command that is disabled by default and you want to grant someone access to use it, do as follows:

const permissions = [
	{
		id: '224617799434108928',
		type: 'USER',
		permission: true,
	},
];

await command.permissions.set({ permissions });




 




1
2
3
4
5
6
7
8
9

Role permissions

Permissions may also be denied (or allowed) at a role scope instead of a single user:

const permissions = [
	{
		id: '464464090157416448',
		type: 'ROLE',
		permission: false,
	},
];

await command.permissions.add({ permissions });



 
 




1
2
3
4
5
6
7
8
9

Bulk update permissions

If you have a lot of commands, you likely want to update their permissions in one go instead of one-by-one. For this approach, you can use GuildApplicationCommandManager#setPermissions:

const fullPermissions = [
	{
		id: '123456789012345678',
		permissions: [{
			id: '224617799434108928',
			type: 'USER',
			permission: false,
		}],
	},
	{
		id: '876543210987654321',
		permissions: [{
			id: '464464090157416448',
			type: 'ROLE',
			permission: true,
		}],
	},
];

await client.guilds.cache.get('123456789012345678')?.commands.permissions.set({ fullPermissions });
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

And that's all you need to know on slash command permissions!