RoleLogicHome › Integrations › Top.gg Voter Role
Reward Top.gg Voters With Discord Roles — Automatically
Members upvote your bot on Top.gg, RoleLogic gives them a Discord role, and the role expires on your schedule (1 hour to 7 days). No webhook babysitting, no scheduled jobs, no manual cleanup.
What you can build with Top.gg Voter Role
Real use cases that ship in production Discord servers using RoleLogic + Top.gg.
Voter perks that auto-expire
Hand voters access to a bonus channel, custom command, or giveaway entry — automatically revoked when the role TTL you set runs out (anywhere from 1 hour to 168 hours).
Climb the Top.gg rankings
Discord roles are visible incentives. Voters see the role land in their member list, remember to vote again on the next cycle, and your bot moves up the Top.gg leaderboard for free.
Tiered loyalty roles
Stack the auto-expiring voter role with permanent loyalty roles ('Top Supporter' for 50+ votes) using the Referral Code plugin or any other RoleLogic condition.
Multi-server voting in one webhook
Top.gg fires one webhook per vote; RoleLogic distributes the role to every Discord server you've registered the plugin in. One vote, roles in every linked server.
How Top.gg Voter Role works
From install to live Top.gg roles in a few minutes.
Connect your Top.gg bot to RoleLogic
Paste the webhook URL and signing secret from your Top.gg bot dashboard into the plugin config. One-time setup, takes a couple of minutes.
Pick your role and expiry window
Choose the Discord role to assign and the TTL — anything from 1 hour to 168 hours (7 days). The role is removed automatically when the timer runs out.
Members vote, roles flow in
Top.gg signs and sends each vote event. RoleLogic verifies the HMAC-SHA256 signature and assigns the role within seconds, then revokes it when the TTL expires.
Frequently asked questions
Common questions about Top.gg Voter Role and RoleLogic.
Do I need a Top.gg API key or webhook secret?
A webhook URL and signing secret — both generated from your Top.gg bot dashboard. RoleLogic verifies every event with HMAC-SHA256 so a malicious caller can't spoof votes.
How long does the voter role last?
You choose — 1 hour to 168 hours (7 days). Top.gg's standard 12-hour vote cooldown is the most common setting, but you can match the timer to your event, season, or perk window.
How fast are roles assigned after a vote?
Within seconds. Top.gg pushes a webhook the moment the vote is recorded; RoleLogic queues the role assignment and the bot grants it on the next sync tick.
What happens when the role expires?
RoleLogic removes it automatically. The expiry worker runs every 60 seconds and revokes any role past its TTL — no manual cleanup, no cron jobs to run.
Can I run this across multiple Discord servers?
Yes. Top.gg fires one webhook per vote and RoleLogic distributes the role to every guild where the plugin is configured, so a single vote can land roles everywhere at once.
Other Discord role integrations
More ways to automate Discord roles with RoleLogic.
YouTube Subscriber Role
Auto-assign Discord roles to verified YouTube subscribers with one-click Google OAuth.
Twitch Follower Role
Real-time Discord roles for Twitch followers and Tier 1 / Tier 2 / Tier 3 subscribers via EventSub.
Member Origin Role
Auto-assign Discord roles by country, timezone, UTC offset, language, platform, browser, or device type — with built-in VPN and impossible-travel detection.
Ship Top.gg Voter Role in 5 minutes
Free plan, no coding, real-time sync. Used by Discord servers of every size — from indie communities to verified gaming servers with hundreds of thousands of members.
Set up Top.gg Voter Role