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

# Autoroles

> Give new members a set of roles the moment they join, and restore the roles of someone who comes back.

Autoroles are the roles Bloom hands out automatically when someone joins your server. They are the usual way to give everyone a base role such as `Member` without a moderator doing it by hand.

<ParamField path="autorole <add|remove|list|none> [role]" type="Administrator">
  Manages the roles given on join. Alias: `joinrole`. Bloom needs **Manage Roles**.

  * `!autorole add Member` replies `Added @Member to autoroles.`
  * Up to **3** autoroles can be active at once.
  * `!autorole list` shows the current set.
  * `!autorole remove @Member` drops one, and `!autorole none` clears them all.
  * The role can be a mention, an ID, or an exact name.
</ParamField>

<Warning>
  Bloom refuses to add a role that sits at or above its own highest role, because Discord will not let it assign one. Move Bloom's role above every autorole in **Server Settings → Roles**.
</Warning>

## When they are applied

Autoroles are given once a member has fully joined, which means they run **after** the [join gate](/security/join-gate). Anyone the gate turns away never receives them, and anyone still waiting on a captcha gets them only once they verify.

## Restoring a returning member's roles

<ParamField path="role restore <user>" type="Manage Roles">
  Gives a member back the roles they had before they left.

  * Bloom keeps a snapshot for **24 hours** after someone leaves, so this only works if they rejoin within a day.
  * The member must be in the server now. Bloom skips any role it or you cannot assign.
</ParamField>

## Troubleshooting

<AccordionGroup>
  <Accordion title="New members are not getting the role">
    Run `!autorole list` and confirm the role is there. Then check Bloom's role sits above it, and that Bloom still has Manage Roles. Members removed by the join gate never reach this step.
  </Accordion>

  <Accordion title="I cannot add a fourth autorole">
    Three is the limit. Remove one with `!autorole remove` first, or combine the permissions you need into fewer roles.
  </Accordion>

  <Accordion title="A listed autorole shows as missing">
    The role was deleted after you set it. Remove the leftover entry with `!autorole none` and add the roles you still want.
  </Accordion>
</AccordionGroup>

## Related pages

<CardGroup cols={2}>
  <Card title="Reaction roles" icon="face-smile" href="/configuration/roles/reaction-roles">
    Let members pick their own roles by reacting to a message.
  </Card>

  <Card title="Join gate" icon="shield-halved" href="/security/join-gate">
    The screening that runs before autoroles are given.
  </Card>

  <Card title="Managing roles" icon="user-gear" href="/configuration/roles/managing-roles">
    Create, edit, and assign roles by command.
  </Card>

  <Card title="Welcome messages" icon="door-open" href="/configuration/welcome">
    Greet the members you just gave a role to.
  </Card>
</CardGroup>