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

To connect your Discord server, go to Dashboard > Discord and copy the bot invite URL. Open it in your browser, select the server you want to link, and authorize the bot. The bot requires the Manage Roles permission to assign roles to members.

Once the bot is in your server, return to the FluxStore dashboard and click Generate Link Code. Use the generated code to link your guild to your store. The dashboard will confirm the connection and display 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, as long as the customer has linked their Discord account. If they haven’t linked yet, the role is queued and assigned once they do.

To create a mapping, go to Dashboard > Discord > Role Mappings, click Add Role Mapping, select 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.