Documentation
Learn how to add your server, vote securely, claim rewards via callbacks, and manage your toplist presence.
Listing your server
To add a server, log in and use the "Add Your Server" flow. Provide the server name, website URL, description, category, version, and any optional metadata like tags, banner image, and callback settings.
Server listings are reviewed automatically and appear in the toplist once created. You can edit your server details anytime from the profile/dashboard area.
Voting process
Players can vote for each server once every 12 hours from the same IP address. Votes are tracked with a lightweight anti-bot check to prevent automated submissions.
When a vote is successful, the server receives leaderboard credit and the vote is logged. Users should then claim rewards via the server's callback system if configured.
Callback rewards
Server owners can enable a callback URL and token when adding or editing a server. After each successful vote, our system sends a POST request to that URL with vote data.
The callback payload includes:
- server_id — the ID of the server
- vote_id — the vote record created
- ip — voter IP
- created_at — vote timestamp
- callback_source — always "toplist"
A header called X-Toplist-Callback-Token is included when a token is configured.
Account and profile
Use the profile page to update your account details, email, and password. Your account also gives you access to the dashboard where you can manage your server listings.
Admins can manage the toplist including featured placements, VIP status, and news publications from the admin console.