Skip to content
ReportToxicity Documentation
Everything you need to understand the platform, connect the Discord bot, use the dashboard, integrate with the API, and work with account and profile features.
Subscription Tiers
Compare Free, Basic, and Premium so communities, moderators, and developers can see exactly what unlocks at each level.
| Feature | Free | Basic | Premium |
|---|---|---|---|
| Billing | |||
| Price | Free | 30 day trial, then $9.99/month | $24.99/month |
| Core | |||
| Submit Reports (Web) | Yes | Yes | Yes |
| Submit Reports (Bot) | Yes | Yes | Yes |
| Player Lookup via Bot | Yes | Yes | Yes |
| Upload Evidence with Reports | Yes | Yes | Yes |
| API Key | - | 1 | 5 |
| Guild Limit | 0 | 1 | 5 |
| Rate Limit (req/min) | 10 | 60 | 300 |
| Discord Bot | |||
| Receive Report Feeds | - | Yes | Yes |
| Category Filtering | - | Yes | Yes |
| Auto Create Threads | - | Yes | Yes |
| Role Pings | - | Yes | Yes |
| High Risk Alerts | - | Yes | Yes |
| Duplicate Detection | - | Yes | Yes |
| Custom Embed Colors | - | Yes | Yes |
| Custom Message Templates | - | - | Yes |
| Toggle Embed Fields | - | - | Yes |
| API & Dashboard | |||
| Guild Management API | - | Yes | Yes |
| Player Context API | - | Yes | Yes |
| Full Reports API | - | - | Yes |
| Stats API | - | - | Yes |
| Community Info | - | Yes | Yes |
| Offender Lookup | - | Yes | Yes |
| Reports Dashboard | - | - | Yes |
Discord Bot Integration
Anyone can add the ReportToxicity bot to a Discord server for free. Basic and Premium unlock report feeds, filtering, alerts, and more advanced automation.
What this section covers
This section explains the practical Discord workflow from bot installation to live moderation feeds. Use it when setting up a new server or comparing which bot features unlock by tier.
How to Get Started
Add the Bot to Your Server
Use the invite link from your account dashboard to add the ReportToxicity bot to your Discord server.
Authenticate with Your API Key
Run /rt-key <your-api-key> in any channel. This connects your server to your subscription.
Configure Report Channels
Go to each channel where you want reports and run /rt-setup. Follow the wizard to set feed type, categories, and notifications.
Start Reporting
Your community can now use /rt-report to submit reports and /rt-history to look up offenders.
Setup Wizard Options
- Feed Type: choose Reports for all reports, Alerts for high risk only, or All for both.
- Categories: filter to categories like Cheating, Griefing, Smurfing, and more.
- Role Ping: Basic and Premium can ping a selected moderator role on new reports.
- Embed Color: Basic and Premium can customize embed colors.
- Custom Template: Premium can build custom message formats using variables like
{offender},{category}, and{game}. - Embed Fields: Premium can toggle individual embed fields on or off.
Available Commands
| Command | Permission | Description |
|---|---|---|
/rt-key <key> |
Administrator | Connect your API key to authenticate the guild |
/rt-setup |
Manage Channels | Configure the current channel for report feeds |
/rt-report |
Everyone | Submit a new toxicity report with evidence |
/rt-history <username> |
Everyone | Look up an offender’s report history |
/rt-code |
Administrator | Display your community code for web submissions |
/rt-remove-channel |
Manage Channels | Remove current channel from receiving reports |
Features by Tier
| Feature | Free | Basic | Premium |
|---|---|---|---|
| Submit Reports | Yes | Yes | Yes |
| Receive Report Feeds | - | Yes | Yes |
| Category Filtering | - | Yes | Yes |
| High Risk Alerts | - | Yes | Yes |
| Auto Create Threads | - | Yes | Yes |
| Role Pings | - | Yes | Yes |
| Duplicate Detection | - | Yes | Yes |
| Custom Embed Colors | - | Yes | Yes |
| Custom Message Templates | - | - | Yes |
| Toggle Embed Fields | - | - | Yes |
| Connected Guilds | 0 | 1 | 5 |
Reports Dashboard
Premium can access reports through the RT Client WordPress plugin, a hosted browser dashboard, or custom tooling built on top of the Full Reports API.
How to think about this area
The dashboard section is for site owners and admins who want a WordPress friendly view of reports, community info, player context, and report level data without building a custom frontend.
How to Install
Install the RT Client Plugin
Download and install the RT Client plugin on your WordPress site through Plugins, Add New, Upload.
Configure Settings
Navigate to Settings > RT Dashboard inside your WordPress admin.
Enter Your API Key
Paste your API key and use the Test Connection control to verify the setup.
Access the Dashboard
Open RT Dashboard in your admin menu to view community info, report stats, and offender lookups.
Dashboard Features by Tier
| Feature | Basic | Premium |
|---|---|---|
| Community Info | Yes | Yes |
| Guild Management | Yes | Yes |
| Offender Lookup | Yes | Yes |
| Reports Dashboard | - | Yes |
Available Shortcodes
- [rt-dashboard] embeds the full dashboard on a page and respects user permissions.
- [rt-report-form] displays a public report submission form.
Settings Options
- API Key: report platform API key.
- Dashboard Access: capability or role access control.
- Require Login for Form: optionally require login before public submissions.
- Default Game: prefill the game field.
- Test Connection: verify the API key works.
- Clear Cache: manually clear cached API responses.
Public Report Form Fields
- Offender Username
- Game
- Category
- Description
- Optional Evidence URLs
Important Form Note
The client plugin’s report form template is based on standard fields plus optional evidence URLs. It is not the same thing as the chunked media upload flow used elsewhere in the report platform.
API Reference
Use the ReportToxicity API to submit reports, query player context, manage guilds, integrate with dashboards, and build moderation tooling.
Reading tip
Public endpoints work without an API key. Authenticated endpoints require a valid subscription key. Basic unlocks core plugin and player context workflows. Premium unlocks full backend report access, including report records, report statuses, stats, and dashboard level tooling.
How to Use the API
Get Your API Key
Log into your ReportToxicity account and generate an API key from your dashboard.
Add the Authentication Header
Include X-RT-API-Key: your-api-key in your request headers.
Make Requests
Send requests to the base endpoint shown below with the endpoint you need.
Access Levels
Basic covers core plugin and context workflows, including guild setup, community info, and player history lookups.
Premium unlocks the full backend reports layer, including full report records, report statuses, stats, and dashboard tools.
Public Endpoints
No API key required. Public access is rate limited.
Authenticated Endpoints Basic
Requires API key and is available to Basic and Premium subscribers.
Premium Endpoints Premium
Full backend report access plus Stats API access.
API Access by Tier
| Feature | Free | Basic | Premium |
|---|---|---|---|
| View Categories | Yes | Yes | Yes |
| Health Check | Yes | Yes | Yes |
| Guild Management | - | Yes | Yes |
| Player Context API | - | Yes | Yes |
| Full Reports API | - | - | Yes |
| Stats API | - | - | Yes |
| Rate Limit (req/min) | 10 | 60 | 300 |
Rate Limits
| Tier | Requests per Minute |
|---|---|
| Public | 10 |
| Basic | 60 |
| Premium | 300 |
X-RT-Tier, X-RT-Features, X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.Upload & Evidence Notes
- Free users can upload evidence with reports.
- Free tier supports up to 3 files per report at 25 MB each.
- The platform also includes chunked upload support in the report system for broader media workflows.
Auth & Profiles
The auth plugin handles login, registration, password reset, Discord OAuth, user profiles, and configurable profile tabs. It also exposes authentication endpoints under the same /rt/v1/ namespace.
How to read this section
This section is split into three parts: user facing shortcodes, profile and Discord account features, and backend endpoints. That keeps the account system readable instead of dumping everything into one long wall of cards.
Available Shortcodes
Useful Shortcode Examples
Profile Tabs
- Profile tabs can be configured in WP Admin under RT Auth > Profile Tabs.
- Tabs can contain shortcodes, HTML, or other content.
- Tabs can be reordered with drag and drop.
- Tabs can be public or private.
- The auth plugin provides built in profile related shortcodes such as [rt_profile_overview] and [rt_edit_profile].
- Profile tabs can also use report plugin shortcodes such as [rt_my_reports] and [rt_public_reports].
Discord OAuth
- Discord OAuth can be enabled for login and account linking.
- The login form can show a Discord OAuth option when enabled.
- Existing users can connect or disconnect a Discord account from the profile UI.
- Discord OAuth supports both login and connect flows.
Auth Endpoints
Discord Auth Endpoints
Usage Notes
- The auth plugin includes AJAX powered login, registration, and password reset forms.
- Registration can be disabled in settings.
- After registration, users can be auto logged in.
- Password reset confirmation requires
email,key, and the new password.
Rate Limit Notes
- Registration endpoint includes rate limiting.
- Login endpoint includes rate limiting.
- The auth plugin is designed to work inside the same ReportToxicity account and profile system.