> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bloombot.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Permission reference

> The Discord permissions Bloom recognizes, the fake-permission names you can grant, and which permission each dashboard module needs.

The tables Bloom's permission checks are built from: the Discord permissions it recognizes, the names you type when granting a fake permission, and the permission each dashboard module requires. For how these checks combine in practice, see [Permissions and hierarchy](/getting-started/permissions).

## Fake permissions

When you grant a fake permission with `!fp grant`, Bloom accepts either the grant name or one of its aliases, then treats the member or role as if it had the matching Discord permission **for Bloom commands only**. A fake permission never grants a real Discord right. The names below are grouped the way `!fp perms` shows them.

<Info>
  Aliases are alternate spellings for the same permission. `!fp grant @Helper ban` and `!fp grant @Helper ban_members` do the same thing.
</Info>

### Administrative

| Grant name            | Discord permission  | Common aliases           |
| --------------------- | ------------------- | ------------------------ |
| `administrator`       | Administrator       | `admin`                  |
| `manage_server`       | Manage Server       | `manage_guild`, `server` |
| `view_audit_log`      | View Audit Log      | `audit_log`, `audit`     |
| `view_guild_insights` | View Guild Insights | `guild_insights`         |

### Moderation

| Grant name         | Discord permission | Common aliases                |
| ------------------ | ------------------ | ----------------------------- |
| `ban_members`      | Ban Members        | `ban`                         |
| `kick_members`     | Kick Members       | `kick`                        |
| `moderate_members` | Timeout Members    | `timeout`, `mute`, `moderate` |

### Channels and threads

| Grant name                 | Discord permission       | Common aliases            |
| -------------------------- | ------------------------ | ------------------------- |
| `manage_channels`          | Manage Channels          | `channels`                |
| `manage_threads`           | Manage Threads           | `threads`                 |
| `create_public_threads`    | Create Public Threads    | `public_threads`          |
| `create_private_threads`   | Create Private Threads   | `private_threads`         |
| `send_messages_in_threads` | Send Messages in Threads | `send_in_threads`         |
| `view_channel`             | View Channel             | `view_channels`           |
| `create_instant_invite`    | Create Invite            | `create_invite`, `invite` |

### Messages

| Grant name              | Discord permission    | Common aliases         |
| ----------------------- | --------------------- | ---------------------- |
| `manage_messages`       | Manage Messages       | `messages`, `purge`    |
| `pin_messages`          | Pin Messages          | `pin`, `pins`          |
| `send_messages`         | Send Messages         | `send`                 |
| `send_tts_messages`     | Send TTS Messages     | `tts`                  |
| `send_polls`            | Send Polls            | `polls`                |
| `send_voice_messages`   | Send Voice Messages   | `voice_messages`       |
| `embed_links`           | Embed Links           | `embeds`               |
| `attach_files`          | Attach Files          | `files`, `attachments` |
| `read_message_history`  | Read Message History  | `read_history`         |
| `add_reactions`         | Add Reactions         | `react`                |
| `mention_everyone`      | Mention Everyone      | `everyone`, `here`     |
| `use_external_emojis`   | Use External Emojis   | `external_emojis`      |
| `use_external_stickers` | Use External Stickers | `external_stickers`    |
| `bypass_slowmode`       | Bypass Slowmode       | `bypass_slow_mode`     |

### Members and roles

| Grant name         | Discord permission | Common aliases              |
| ------------------ | ------------------ | --------------------------- |
| `manage_roles`     | Manage Roles       | `roles`                     |
| `change_nickname`  | Change Nickname    | `change_nick`               |
| `manage_nicknames` | Manage Nicknames   | `nicknames`, `manage_nicks` |

### Expressions and events

| Grant name                 | Discord permission | Common aliases                     |
| -------------------------- | ------------------ | ---------------------------------- |
| `manage_guild_expressions` | Manage Expressions | `manage_emojis`, `manage_stickers` |
| `create_guild_expressions` | Create Expressions | `create_emojis`, `create_stickers` |
| `manage_events`            | Manage Events      | `events`                           |
| `create_events`            | Create Events      | `create_scheduled_events`          |

### Voice and stage

| Grant name            | Discord permission  | Common aliases     |
| --------------------- | ------------------- | ------------------ |
| `connect`             | Connect             |                    |
| `speak`               | Speak               |                    |
| `mute_members`        | Mute Members        | `voice_mute`       |
| `deafen_members`      | Deafen Members      | `deafen`           |
| `move_members`        | Move Members        | `move`             |
| `priority_speaker`    | Priority Speaker    |                    |
| `stream`              | Video               | `go_live`, `video` |
| `use_vad`             | Use Voice Activity  | `voice_activity`   |
| `request_to_speak`    | Request to Speak    |                    |
| `use_soundboard`      | Use Soundboard      |                    |
| `use_external_sounds` | Use External Sounds | `external_sounds`  |

### Apps and insights

| Grant name                            | Discord permission          | Common aliases         |
| ------------------------------------- | --------------------------- | ---------------------- |
| `manage_webhooks`                     | Manage Webhooks             | `webhooks`             |
| `use_application_commands`            | Use Application Commands    | `slash_commands`       |
| `use_embedded_activities`             | Use Activities              | `activities`           |
| `use_external_apps`                   | Use External Apps           | `external_apps`        |
| `view_creator_monetization_analytics` | View Monetization Analytics | `creator_monetization` |

<Warning>
  The `administrator` fake permission makes a member pass every Bloom permission check. Grant it as carefully as you would the real Administrator permission.
</Warning>

## How Bloom resolves a permission

For a command that needs a permission, Bloom allows the member if any of these holds, checked in order:

| Condition                                                                                  | Result                                          |
| ------------------------------------------------------------------------------------------ | ----------------------------------------------- |
| Member is the server owner                                                                 | Passes                                          |
| Member has Discord Administrator                                                           | Passes                                          |
| Member has the real Discord permission (in the channel, if the command checks the channel) | Passes                                          |
| Member has the matching fake permission                                                    | Passes                                          |
| None of the above                                                                          | Blocked, and Bloom names the missing permission |

Bloom checks its own bot permission for the action separately, in the same channel. See the guide for [how these two checks differ](/getting-started/permissions#you-need-and-bloom-needs).

## Dashboard module access

Opening a server's dashboard requires that you are an **administrator**, the **server owner**, or hold a **dashboard access role** configured for that server. Once inside, each module is visible only to members who hold the permission below. Administrators and the owner see everything.

| Module               | Requires                         |
| -------------------- | -------------------------------- |
| Server Configuration | Administrator                    |
| Automod              | Administrator                    |
| Jail                 | Administrator                    |
| Logging              | Administrator                    |
| Join Gate            | Administrator                    |
| Tickets              | Administrator                    |
| Aliases              | Manage Server                    |
| Forms                | Manage Server                    |
| Welcome Messages     | Manage Server                    |
| Booster Messages     | Manage Server                    |
| Bump Reminders       | Manage Server                    |
| Leveling             | Manage Server                    |
| Starboard            | Manage Server                    |
| Appeals              | Ban Members                      |
| Autoresponders       | Manage Channels                  |
| Autoreactions        | Manage Messages                  |
| Antinuke             | Server owner or anti-nuke admin  |
| Fake Permissions     | Server owner or anti-nuke admin  |
| Server Analytics     | Any member with dashboard access |

For the login flow and how a dashboard access role is granted, see [Dashboard access](/getting-started/dashboard).

## Hierarchy checklist

Permissions decide what is allowed; role position decides what is possible. Before relying on Bloom to manage roles or members, confirm:

* Bloom's own role sits **above** the roles of members you moderate.
* Bloom's role sits **above** every role it assigns: level rewards, autoroles, and the mute and jail roles.
* A moderator's highest role is above the members they need to action, since Discord blocks actions against anyone ranked higher.
* The **@everyone** role and **managed roles** (bot or integration roles) cannot receive fake permissions.

## Related pages

<CardGroup cols={2}>
  <Card title="Permissions and hierarchy" icon="user-lock" href="/getting-started/permissions">
    The task guide these tables support: reading errors, delegating with fake permissions, and fixing hierarchy.
  </Card>

  <Card title="Dashboard access" icon="sliders" href="/getting-started/dashboard">
    Signing in and configuring who can open the dashboard.
  </Card>
</CardGroup>