Profile and categories
Update your public name, description, service categories, and tags. Changes sync to a private preview until you publish them.
FOR MYBB FORUM OWNERS
Put your community on the map.
List your MyBB forum in a directory built around real community activity. Set up and manage your listing from MyBB Admin CP.
GET STARTED
Install and verify your forum
You’ll need MyBB 1.8.38 or later, PHP 8.1–8.4 with Sodium and cURL, a supported MySQL or MariaDB database, and access to an owner email inbox.
- 01
Download the plugin
Get the latest release from the MyBBForums plugin repository. Unpack the release before copying its files.
- 02
Copy the plugin files
Copy
mybbforums.phpintoinc/plugins/, the library intoinc/plugins/mybbforums/, and the scheduled task intoinc/tasks/. Copy the Admin CP module intoadmin/modules/config/. - 03
Add the verification file
Copy
mybbforums-verify.phpto your MyBB forum’s public base path. The service uses it to verify that this MyBB installation controls the forum URL. - 04
Activate and configure
In Admin CP, install and activate MyBBForums Toplist under Configuration → Plugins. Then open Configuration → MyBBForums and set the service URL to
https://mybbforums.com/api/v1.
YOUR LISTING
Configure first. Publish when you’re ready.
Enter your forum name, description, owner email, categories, and tags in the plugin settings. Choose up to three categories and ten tags. A logo and banner are optional.
You can save and edit your listing while email confirmation is pending. The listing stays private until the owner email is confirmed, the service verifies the installation, and you choose Publish listing.
Read the full plugin setup guide ↗OWNERSHIP CHECKS
Confirmation protects your listing
Open the confirmation link sent to your owner email. The link expires and can only be used once. The plugin also proves control of your MyBB installation using its private signing key and the verification file.
A forum URL by itself cannot claim an existing listing. A new claim cannot see or change the current owner’s settings before its own email is confirmed. Keep the plugin’s private data directory during upgrades and server moves so your installation identity and queued stats stay available.
MANAGE FROM ADMIN CP
One place for your listing and stats
Activity reports
The hourly MyBB task reports aggregate active users and new public posts for the last 7 and 30 days. A local retry queue keeps failed reports for the next sync.
Connection status
See listing state, last sync, accepted stats time, score, metric availability, queue age, and actionable errors. Choose Sync and refresh status for an immediate check.
Privacy and ranking
Only aggregate counts are sent; member names and individual activity are not. You can exclude test or service account IDs. Suspicious jumps are held for moderator review before they affect score.
WHEN THINGS CHANGE
Keep control as your forum changes
- Change owner email
- Request a new address in Admin CP. Your current verified address stays authoritative until the new one confirms.
- Transfer ownership
- Start a transfer to the new owner’s email. The recipient must confirm, and the current owner is notified.
- Move or reinstall
- Preserve the private plugin directory when possible. For a new installation, use the recovery request in Admin CP; a URL alone cannot reclaim the listing.
- Pause or remove
- Unpublish to hide the listing while keeping its configuration. Deletion removes the listing and requires a new claim to list it again.
- Suspension
- Review the reason shown in Admin CP, address the issue, then submit an appeal for moderator review.