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

# Permissions

> Who can manage giveaways, and which permissions the bot needs to work.

There are two sides to permissions: **who can use the bot's commands**, and **what the bot itself is allowed to do** in your server.

## Who can manage giveaways

A member can use the giveaway management commands (`/gstart`, `/gend`, `/greroll`, `/gpause`, `/gresume`, `/gedit`, `/gdelete`, `/glist`, `/gfix`) if they have **any** of these:

> **Administrator**
>
> Full access.

> **Manage Server**
>
> The standard permission for managing the server.

> **A Giveaway Manager role**
>
> A role you choose, so trusted hosts do not need Manage Server.

> [!TIP]
>
> Giving hosts a **Giveaway Manager role** is safer than handing out Manage Server. They can run giveaways without being able to change other server settings.

## Command permissions at a glance

| Commands | Who can use them |
| - | - |
| `/gstart`, `/gcreate`, `/gdrop`, `/glast`, `/gschedule`, `/gtemplate`, `/gedit`, `/gend`, `/gpause`, `/gresume`, `/greroll`, `/gdelete`, `/gfix` | Manage Server, Administrator or a Giveaway Manager role |
| `/glist` | Anyone who can see the channel |
| `/settings`, `/setcolor`, `/setemoji` | Manage Server |
| `/levelsetup`, `/setxp`, `/setlevel`, `/setlang` | Manage Server |
| `/starboard`, `/counting` | Manage Server |
| `/sticky` | Manage Messages |
| `/premium-info`, `/premium-link`, `/premium-activate`, `/premium-settings` | Manage Server |
| `/premium-transfer` | The server owner |
| `/afk`, `/rank`, `/top`, `/translate`, `/help`, `/ping`, `/invite` | Everyone |

Server admins can restrict where each command works. See [Command customization](https://docs.giveawayx.lol/features/command-customization.md).

## What the bot needs

**Required**

| Permission | Why |
| - | - |
| View Channel | See the giveaway channel |
| Send Messages | Post and update giveaways |
| Embed Links | Show rich giveaway messages |

**For some features**

| Permission | Needed for |
| - | - |
| Add Reactions | Giveaways that use **reaction** entry |
| Manage Roles | Winner roles and role rewards (the bot's role must sit **above** the roles it gives) |
| Create Threads | Winner threads |
| Manage Webhooks | Messages sent with a custom name and avatar |
| Manage Messages | Sticky messages and cleaning up |

> [!WARNING]
>
> If the bot cannot see or post in the channel, the giveaway cannot start and `/gfix` will report a permission problem. Fix the channel permissions first.

> [!CAUTION]
>
> Never give the bot a role **below** the winner roles you want it to hand out. Discord blocks roles from being assigned to a role that is higher than the bot's own.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.