Discord Role Shop Setup Guide: Zero to First Sale

Setting up a Discord role shop involves five steps: deciding what to sell, installing the bot correctly, creating a product, sharing the shop with members, and checking your dashboard once a sale comes in. Most of the failures people run into happen at step two, specifically around role hierarchy and permissions, so this guide spends extra time there. If you have not read the overview of monetization options first, see the guide to monetizing a Discord server for context on how a role shop fits alongside other approaches.

Key Takeaways

• Decide on one or two roles to sell before touching setup — a focused shop is easier to test and explain to members.
• The bot's own role must sit above any role you intend to sell in the server's role list, and it needs Manage Roles permission. Skipping this is the most common reason automatic delivery fails.
• Products are created by linking a Discord role to a price in the web dashboard after running /setup.
• Members buy through /shop in your server, and the role is delivered automatically the moment payment succeeds.
• After your first sale, check the dashboard for the recorded sale, volume, fee, and available balance — the minimum payout threshold is €2.

1. Decide what to sell as roles or perks

Before installing anything, pick what a paying member actually gets. A role shop only works if the role attached to it delivers something visible or useful — a colored name, access to a private channel, a badge next to a username, or priority in some in-server system you already run.

Keep the first product simple. One role at one price is easier to explain in an announcement and easier to troubleshoot than three tiers launched at once. You can add tiers later once the first one is working end to end.

Whatever you choose, the price has to clear the platform's €0.50 minimum product price, so factor that into how you scope a perk — a very small add-on may need to be bundled with something else to make sense at that floor.

2. Install the bot and set role hierarchy and permissions correctly

This is the step that determines whether automatic role delivery works at all, and it is the one most setup guides gloss over. Discord decides which roles a bot is allowed to assign based on where the bot's own role sits in the server's role list, not based on what permissions look correct in a settings screen.

Add the bot and check the role list

After adding the bot to your server, open your server's role settings and look at the ordered list of roles. Every Discord server has one, even if you have never touched it — new roles are usually added at the bottom by default.

Move the bot's role above the role you plan to sell

Drag the bot's role so it sits above any role you intend to sell. A bot can only assign or remove roles that rank below its own role in the hierarchy. If the role you are selling sits above or at the same level as the bot's role, the bot will not be able to grant it, even if every other setting looks correct.

Grant the bot Manage Roles permission

The bot also needs the Manage Roles permission on your server. Without it, role assignment will fail regardless of where the role sits in the hierarchy. Hierarchy position and this permission are two separate requirements, and both have to be satisfied together.

Once both are in place, run /setup to confirm the bot is configured for the server before moving to product creation.

3. Create your first product

Product creation happens in the web dashboard, not in Discord itself. A product is a link between a Discord role and a price: you choose the role you already positioned correctly in step two, set a price at or above the €0.50 minimum, and save it.

Give the product a name members will recognize from the role name or the perk it unlocks, so there is no ambiguity in /shop about what they are buying. If you are unsure how the 3% early-access platform fee affects what you take home on a given price, the breakdown of DonateBot's fee structure covers exactly what is charged and when.

Save the product before announcing anything. It is worth buying it yourself on a test account, if you have one, to confirm the role actually lands before members see the shop.

4. Share /shop with members

Once a product exists, members browse and buy it by running /shop in your server. Post an announcement in a channel members actually read, explaining what the role unlocks and how to buy it with the command.

Pinning the announcement, or adding a short line to your server's rules or welcome channel, keeps the shop discoverable after the initial post scrolls away. A role shop only generates sales if members know it exists and understand what they get for the price.

5. Check the dashboard after your first sale

When a member completes a purchase through /shop, the role is delivered automatically and the sale is recorded in the dashboard. After your first sale, check four things there:

1. Sales — confirm the transaction shows up with the correct product and price.
2. Volume — the running total of completed sales, useful for tracking growth over time.
3. Fees — the 3% platform fee taken on that specific sale, shown against the gross amount.
4. Available balance — your net proceeds. Funds are only eligible for payout once the balance reaches the €2 minimum payout threshold.

If the dashboard shows the sale as completed but the member reports they did not receive the role, that almost always points back to the hierarchy or permission issue described below rather than a payment problem.

The most common setup mistake

The single most common reason automatic role delivery breaks is one of two things: the bot's role is not placed above the role being sold, or the bot is missing the Manage Roles permission. Both have to be correct at the same time — fixing one without the other still results in a failed delivery.

If a member pays and does not receive their role, recheck the role order first, then confirm the permission is still granted. Server permission changes, new roles added later, or a reordering during other server maintenance can quietly break a setup that worked before.

Next step

With one product live and a completed sale showing correctly in the dashboard, the setup itself is done. From here, the work shifts to deciding what additional roles or tiers are worth adding, and how to keep the shop visible to new members as your server grows. The Discord server monetization guide is the place to go for that broader picture.