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

# FAQ

> Frequently asked questions and answers

## Getting Started

<AccordionGroup>
  <Accordion title="How do I invite the bot to my server?" icon="plus">
    Click the invite link provided on the website or documentation. Make sure you have **Manage Server** permission in the server you want to add the bot to. The bot will request necessary permissions during the invite process.
  </Accordion>

  <Accordion title="What permissions does the bot need?" icon="key">
    **Essential Permissions:**

    * View Channels
    * Send Messages
    * Embed Links
    * Attach Files
    * Read Message History
    * Add Reactions

    **For Specific Features:**

    * **Manage Roles** — For role management commands
    * **Manage Emojis and Stickers** — For emoji/sticker stealing
    * **Manage Webhooks** — For webhook commands
    * **Manage Channels** — For channel info commands
  </Accordion>

  <Accordion title="How do I set up the bot after inviting?" icon="gear">
    The bot works right away with the default prefix `~`. You can:

    1. Test it with `~ping` to confirm it's working
    2. Use `~help` to see available commands
    3. Configure features like vanity tracking, embeds, or custom prefix as needed
  </Accordion>

  <Accordion title="What is the default prefix?" icon="hashtag">
    The default prefix is `~` (tilde). All commands start with this prefix, for example: `~ping`, `~userinfo`, `~steal`
  </Accordion>

  <Accordion title="How do I change the prefix?" icon="pen">
    Server administrators with **Manage Server** permission can change the prefix using the prefix management commands. You can also enable no-prefix mode if supported.
  </Accordion>
</AccordionGroup>

***

## Common Issues

<AccordionGroup>
  <Accordion title="Bot is not responding to commands" icon="robot">
    **Check these common causes:**

    * Verify the bot is online (green status)
    * Make sure you're using the correct prefix (`~`)
    * Check if the bot has **Send Messages** permission in the channel
    * Ensure you're not on cooldown for that command
    * Try the command in a different channel

    **Still not working?** Contact support with details about the command you tried.
  </Accordion>

  <Accordion title="Bot says 'Missing Permissions'" icon="shield-exclamation">
    This means either you or the bot lacks required permissions:

    **If you're missing permissions:**

    * Check if you have the required role/permission for that command
    * Most management commands need **Manage Roles**, **Manage Channels**, etc.

    **If the bot is missing permissions:**

    * Check bot's role permissions in Server Settings
    * Make sure bot's role is high enough in the hierarchy
    * Grant the specific permission the error message mentions
  </Accordion>

  <Accordion title="Commands are slow or timing out" icon="clock">
    **Common causes:**

    * Discord API slowdown (temporary)
    * Large server with many members/roles/channels
    * Complex operations (like mass role assignment)

    **Solutions:**

    * Wait a moment and try again
    * For mass operations, be patient (they take time)
    * If persistent, check Discord status page
  </Accordion>

  <Accordion title="Bot went offline" icon="power-off">
    Bots occasionally restart for:

    * Updates and maintenance
    * Server reboots
    * Bug fixes

    **The bot should come back online within a few minutes.** If it's offline for more than 10 minutes, check the support server for announcements.
  </Accordion>

  <Accordion title="Vanity tracking not working" icon="link">
    **Remember:** Vanity tracking requires **Aurelia bot**, not just Celestia.

    **Steps to fix:**

    1. Make sure Aurelia is invited to your server
    2. Verify Celestia is present (Aurelia requires it)
    3. Check vanity features are unlocked in Celestia
    4. Confirm vanity URL is set correctly with `/vanity view`
    5. Ensure Aurelia has **Read Messages** permission

    See the [Vanity Tracking guide](/vanity-tracking) for setup help.
  </Accordion>

  <Accordion title="Emoji/sticker stealing fails" icon="image">
    **Common reasons:**

    * Discord CDN links expire after a few hours
    * Image file is too large (>256KB for emojis, >512KB for stickers)
    * Server has reached emoji/sticker limit
    * Unsupported format (WebP, Lottie)

    **Solutions:**

    * Reply to the original message instead of using old links
    * Check server emoji/sticker limits
    * Convert WebP to PNG for emojis
    * Lottie stickers cannot be stolen (vector format)
  </Accordion>
</AccordionGroup>

***

## Features & Limitations

<AccordionGroup>
  <Accordion title="What's the difference between Celestia and Aurelia?" icon="code-compare">
    **Celestia** — Main bot with all core features:

    * Moderation commands
    * Role management
    * Emoji/sticker management
    * User/server info
    * Utilities
    * Embed builder

    **Aurelia** — Extension bot specifically for vanity tracking:

    * Vanity URL monitoring only
    * Requires Celestia to be present
    * Better performance for vanity features
    * Must be invited separately
  </Accordion>

  <Accordion title="Can I use multiple prefixes?" icon="at">
    The bot supports one custom prefix per server. However:

    * **Slash commands** (like `/vanity`) always work alongside prefix commands
    * **No-prefix mode** can be enabled per server
    * **Self-prefix** — Users can set their own personal prefix with `~selfprefix <prefix>`

    Your personal prefix will work only for you across all servers with the bot!
  </Accordion>

  <Accordion title="How many emojis/stickers can I steal at once?" icon="copy">
    **Single steal (`~steal`):** 1 emoji or sticker at a time (with interactive selection)

    **Multi steal (`~stealemojimulti`):** Up to 15 emojis per command

    **Note:** Stickers can only be stolen one at a time using `~steal`.
  </Accordion>

  <Accordion title="What file formats are supported for emojis/stickers?" icon="file">
    **Emojis:**

    * ✅ PNG (static)
    * ✅ GIF (animated)
    * ❌ WebP (not supported)
    * ❌ APNG (use GIF for animation)

    **Stickers:**

    * ✅ PNG (static)
    * ✅ APNG (animated)
    * ✅ GIF (animated)
    * ❌ Lottie (vector format, cannot be stolen)
  </Accordion>

  <Accordion title="Do Discord CDN links expire?" icon="link-slash">
    **Yes!** Discord attachment URLs expire after a few hours for security reasons.

    **Best practices:**

    * Always reply to the original message when stealing emojis/stickers
    * Don't save CDN links for later use
    * If a link expired, go back to the original message
    * Use fresh links whenever possible
  </Accordion>

  <Accordion title="What are server boost tier benefits?" icon="rocket">
    **Emoji Limits:**

    * Tier 0: 50 static + 50 animated
    * Tier 1+: 100 static + 100 animated

    **Sticker Limits:**

    * Tier 0: 5 stickers
    * Tier 1: 15 stickers
    * Tier 2: 30 stickers
    * Tier 3: 60 stickers

    **Other Benefits:**

    * Higher bitrate for voice channels
    * Vanity URL (Tier 1+)
    * Server banner (Tier 2+)
  </Accordion>
</AccordionGroup>

***

## Commands & Usage

<AccordionGroup>
  <Accordion title="How do I see all available commands?" icon="list">
    Check out the full command list on the website:

    **[https://celestia-bot-chi.vercel.app/#commands](https://celestia-bot-chi.vercel.app/#commands)**

    The website provides:

    * Complete list of all commands
    * Detailed descriptions
    * Usage examples
    * Command categories

    You can also use `~help` in Discord for a quick overview.
  </Accordion>

  <Accordion title="Can I use commands without a prefix?" icon="terminal">
    Some servers may have **no-prefix mode** enabled, which allows commands to work without the prefix. This is a server-specific setting configured by administrators.

    Slash commands (like `/vanity`) always work regardless of prefix settings.
  </Accordion>

  <Accordion title="How do I use variables in messages?" icon="brackets-curly">
    Variables are placeholders that get replaced with actual values. Use them in embeds, messages, and webhooks:

    **Examples:**

    * `{user.mention}` → @username
    * `{guild.name}` → Server name
    * `{guild.count}` → Member count
    * `{timestamp}` → Current date/time

    See the full [Variables guide](/variables) for all available variables.
  </Accordion>

  <Accordion title="Where can I find my saved embeds?" icon="code">
    View all your saved embeds with:

    ```bash theme={null}
    /embed list
    ```

    Your embeds are saved to your account and can be used in any server where the bot is present. Use `/embed builder` to create new embeds.
  </Accordion>
</AccordionGroup>

***

## Permissions & Roles

<AccordionGroup>
  <Accordion title="What permissions do I need to use moderation commands?" icon="gavel">
    **Role Management:** Manage Roles

    **Emoji/Sticker Management:** Manage Emojis and Stickers

    **Channel Management:** Manage Channels

    **Webhook Commands:** Manage Webhooks

    **Server Settings:** Manage Server (for prefix changes, vanity, etc.)

    **Most info commands** (ping, userinfo, serverinfo, etc.) require no special permissions.
  </Accordion>

  <Accordion title="Why can't the bot manage certain roles?" icon="ban">
    Discord uses **role hierarchy** — roles can only manage roles below them.

    **Rules:**

    * Bot's highest role must be above the role it's managing
    * Your highest role must be above the role you're managing (unless you're server owner)
    * Managed roles (bot roles, integrations) have special restrictions

    **Solution:** Move the bot's role higher in Server Settings → Roles.
  </Accordion>

  <Accordion title="What is role hierarchy?" icon="layer-group">
    Roles are ordered from top to bottom in Server Settings. A role can only manage (assign, remove, edit) roles that are positioned below it.

    **Example:**

    ```
    @Owner (highest)
    @Admin
    @Moderator
    @Bot Role  ← Bot can manage roles below this
    @Member
    @Everyone (lowest)
    ```

    The bot cannot manage @Admin, @Moderator, or roles above @Bot Role.
  </Accordion>

  <Accordion title="Can I protect certain roles from mass assignment?" icon="shield">
    Yes! You can designate certain roles as "bot roles" to prevent them from being mass-assigned to humans using commands like `~role humans`.

    This is useful for:

    * Integration roles
    * Bot-specific roles
    * Special permission roles

    Bot roles can still be assigned to actual bots, just not to human members in bulk operations.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="'Role is higher than bot's role' error" icon="exclamation-triangle">
    This means the role you're trying to manage is higher than the bot's highest role in the hierarchy.

    **Solution:**

    1. Go to Server Settings → Roles
    2. Drag the bot's role higher in the list
    3. Make sure it's above all roles you want the bot to manage
    4. Try the command again
  </Accordion>

  <Accordion title="Webhook not found/deleted" icon="webhook">
    **Causes:**

    * Webhook was manually deleted from channel settings
    * Channel was deleted
    * Webhook URL is incorrect

    **Solutions:**

    * Create a new webhook in channel settings
    * Copy the new webhook URL
    * Update your commands with the new URL
    * Keep webhook URLs secure (don't share publicly)
  </Accordion>

  <Accordion title="Embed not sending" icon="code">
    **Common issues:**

    * Embed doesn't exist (check with `/embed list`)
    * You're not the owner of the embed
    * Bot missing **Send Messages** or **Embed Links** permission
    * Embed has no title or description (at least one required)

    **Solutions:**

    * Verify embed exists and you own it
    * Check bot permissions in the channel
    * Edit embed to include at least title or description
  </Accordion>

  <Accordion title="AFK status not clearing" icon="moon">
    AFK status automatically clears when you send **any message** in the server.

    **If it's not clearing:**

    * Make sure you actually sent a message (reactions don't count)
    * Bot must be online and running
    * Check if bot has **Read Messages** permission

    **Workaround:** Run `~afk` again to reset it manually.
  </Accordion>

  <Accordion title="Image link expired when stealing emoji" icon="link-slash">
    Discord attachment URLs expire after a few hours.

    **Solutions:**

    * Reply to the original message and use `~steal`
    * Don't copy links from old messages
    * Use message IDs or Discord message links instead
    * For message links: `~steal https://discord.com/channels/...`

    The bot will try to refetch fresh URLs when possible.
  </Accordion>
</AccordionGroup>

***

## Support & Updates

<AccordionGroup>
  <Accordion title="How do I report a bug?" icon="bug">
    Report bugs using the `~report` command:

    ```bash theme={null}
    ~report [description of bug]
    ```

    Include as much detail as possible:

    * What command you used
    * What you expected to happen
    * What actually happened
    * Any error messages
  </Accordion>

  <Accordion title="Where can I suggest new features?" icon="lightbulb">
    Submit feature suggestions using:

    ```bash theme={null}
    ~suggest [your suggestion]
    ```

    Be specific about:

    * What feature you want
    * Why it would be useful
    * How it would work

    All suggestions are reviewed by the development team!
  </Accordion>

  <Accordion title="How do I get support?" icon="life-ring">
    **Multiple ways to get help:**

    1. **Documentation** — Check this website for guides
    2. **In-Discord** — Use `~report` or `~suggest` commands
    3. **Support Server** — Join the support server (link on website)
    4. **Bug Reports** — Use `~report` for technical issues

    Most questions can be answered by browsing the documentation!
  </Accordion>

  <Accordion title="Where are update logs/changelogs?" icon="scroll">
    Update logs and changelogs are posted in:

    * Support server announcements
    * Bot status channel (if configured in your server)
    * Official website/documentation updates section

    Major updates are announced across all channels.
  </Accordion>

  <Accordion title="Is there a support server?" icon="discord">
    Yes! Join the official support server:

    **[https://discord.gg/BCUaYVVN55](https://discord.gg/BCUaYVVN55)**

    Get help with:

    * Direct support from staff
    * Community discussions
    * Update announcements
    * Feature suggestions
    * Bug reports
  </Accordion>
</AccordionGroup>

***

## Still Have Questions?

<CardGroup cols={2}>
  <Card title="Browse Commands" icon="book" href="https://celestia-bot-chi.vercel.app/#commands">
    Check out the full command list and documentation on the website
  </Card>

  <Card title="Join Support Server" icon="discord" href="https://discord.gg/BCUaYVVN55">
    Get direct help from staff and community members
  </Card>
</CardGroup>