Discord

Connect your Discord server to FluxStore for automatic role assignment when customers make purchases. You can also enable purchase notifications and let customers link their Discord account at checkout.

Setup

There are three steps: add the bot to your Discord server, generate a link code in FluxStore, then run the link command inside Discord.

1. Add the bot to your Discord server. In FluxStore, open Dashboard > Discord and copy the Bot invite URL. Open the URL in a browser, pick the Discord server you want to link, and authorize. The bot needs the Manage Roles permission to assign roles later.

2. Generate a link code. Back in Dashboard > Discord, click Generate Link Code. FluxStore shows you a short code (and a countdown — the code expires after a few minutes).

3. Run /fluxstore link <code> in your Discord server. In any text channel of the Discord server you added the bot to, type:

/fluxstore link YOUR-CODE-HERE

The bot replies confirming the link, and the FluxStore dashboard updates to show your server name and member count.

Role Mappings

Role mappings connect your store packages to Discord roles. When a customer purchases a mapped package, the bot automatically assigns the corresponding Discord role — but only if the customer has linked their Discord account to their order. If they haven’t, the role assignment is queued and runs the moment they do link.

Customers link their Discord either:

• At checkout, when you’ve enabled the Checkout Link Prompt option (see Settings below). The checkout page shows a “Connect Discord” button before the Pay button.
• From their purchase history page after the fact. There’s a “Link Discord” button visible whenever the order has an unlinked Discord-mapped role.

To create a mapping, go to Dashboard > Discord > Role Mappings, click Add Role Mapping, pick a package and a Discord role, and save. You can map multiple packages to the same role, or one package to multiple roles.

Settings

Once your guild is linked, you can configure these options in Dashboard > Discord:

• Enable Discord Link. Allow customers to link their Discord account to their store profile.
• Require Discord Link. Require customers to link their Discord account before completing checkout. This may reduce conversions if your audience isn’t primarily on Discord.
• Purchase Notifications. Send a message to a chosen Discord channel each time a purchase is completed. The bot needs Send Messages permission in the target channel.
• Welcome Message. A custom message displayed when a customer links their Discord account.
• Checkout Link Prompt. Message shown during checkout prompting the customer to link their Discord account.

Manual Assignment and Retries

You can manually assign or remove roles from Dashboard > Customers by selecting a customer and navigating to their Discord section.

If a role assignment fails (for example, the customer left the server), go to Dashboard > Discord > Role Assignments, filter by Failed status, and click Retry.

Troubleshooting

Bot cannot assign roles. Make sure the bot’s role is higher in the Discord role hierarchy than any role it needs to assign. Discord prevents bots from assigning roles above their own position. Also verify the bot has Manage Roles permission.

Purchase notifications not appearing. Confirm notifications are enabled, the channel ID is set correctly, and the bot has Send Messages permission in that channel.

Customer cannot link their account. Check that Discord linking is enabled in your settings. The customer must also be a member of the linked server.

Unlinking

To disconnect your Discord server, go to Dashboard > Discord and click Unlink Guild. This removes all role mappings and stops automatic assignments and notifications. Roles already assigned to Discord members are not removed. You must remove those manually in Discord.