> ## 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 errors

> Work out why Bloom refused a command or could not act on a member, from the cheapest check to the most involved.

Most refusals come down to one of four things. Work through them in order.

## Read the pronoun first

Bloom always says whose permission is missing, and that points straight at the fix.

| Bloom says                           | Meaning                        | Fix                                                                                                 |
| ------------------------------------ | ------------------------------ | --------------------------------------------------------------------------------------------------- |
| *You need the following permissions* | You lack the user permission   | Give the member the Discord permission, or a matching [fake permission](/security/fake-permissions) |
| *I need the following permissions*   | Bloom lacks the bot permission | Give Bloom's role that permission, and check the channel is not denying it                          |

<Steps>
  <Step title="Check the permission itself">
    Confirm whoever is blocked actually holds the permission the command names. Administrators and the server owner pass every Bloom check.
  </Step>

  <Step title="Check the channel">
    A channel override can deny a permission in one channel while the role grants it everywhere else. Bloom uses your effective permission in the channel you ran the command in, and its own in that same channel. Send Messages and Embed Links are the two that most often block a reply.
  </Step>

  <Step title="Check role position">
    If the permission is clearly present but the action still fails on one member, it is almost always hierarchy. Bloom, and the acting moderator, must have a higher top role than the target. Discord enforces this and no permission overrides it.
  </Step>

  <Step title="Check for a special rule">
    Some commands are not permission-gated at all. `antinuke`, `staffroles`, and `fakepermissions` are limited to the server owner and anti-nuke admins. `hardban` and `antinuke setup` are owner-only.
  </Step>
</Steps>

<Warning>
  Never fix a permission problem by granting Administrator. It bypasses every check in the server, including the ones protecting you. Grant the specific permission, or use a [fake permission](/security/fake-permissions) to delegate just the Bloom command.
</Warning>

## Common cases

<AccordionGroup>
  <Accordion title="Bloom has the permission but says it cannot act on a member">
    Hierarchy. Bloom's role is at or below the target's highest role. Open **Server Settings → Roles** and drag Bloom's role above every role it needs to manage.
  </Accordion>

  <Accordion title="A moderator can ban some members but not others">
    Also hierarchy, on their side. Discord will not let anyone action a member whose highest role is above their own, no matter what permissions they hold.
  </Accordion>

  <Accordion title="Bloom replies in some channels but not others">
    A channel override is denying Bloom Send Messages, Embed Links, or View Channel there. Check the channel's permission list for Bloom's role.
  </Accordion>

  <Accordion title="A member has a fake permission but Discord still blocks them">
    Fake permissions satisfy Bloom's checks only. Anything Discord itself gates on that member's rights still requires the real permission.
  </Accordion>

  <Accordion title="A dashboard module is hidden">
    Modules appear only to members holding the matching permission. Getting in through a dashboard access role shows you only the modules for permissions you hold. See the [module matrix](/reference/permissions#dashboard-module-access).
  </Accordion>
</AccordionGroup>

## Related pages

<CardGroup cols={2}>
  <Card title="Permissions and hierarchy" icon="user-lock" href="/getting-started/permissions">
    How the checks work, rather than how to fix them.
  </Card>

  <Card title="Permission reference" icon="table-list" href="/reference/permissions">
    The permission tables behind every check.
  </Card>

  <Card title="Fake permissions" icon="key" href="/security/fake-permissions">
    Delegating Bloom commands without Discord permissions.
  </Card>

  <Card title="Support server" icon="discord" href="https://discord.gg/HYSgTQ6SHR">
    Ask if none of the above explains it.
  </Card>
</CardGroup>
