Handling Moderation Rejections
Understanding the moderation polling flow and how to recover when an audio asset is rejected.
Every audio file uploaded to Roblox goes through an automated (and sometimes manual) moderation review before it can be played in-game. This page explains how the Bulk Uploader manages that process and what to do if an asset is rejected.
1. How the Moderation Flow Works
When you upload an audio batch, the initial upload step is typically very fast. However, the assets will often enter a "Reviewing" status on Roblox's end.
To handle this, the app runs an intelligent background poller. It continuously checks Roblox for status updates on your recently uploaded assets. Once an asset clears moderation and becomes "Approved," the app proceeds to automatically grant permissions or sync it to your DataStore (if those features are enabled).
2. When an Asset is Rejected
Immediate Queue Halt: If the poller detects that Roblox has rejected an asset, the entire upload queue will halt immediately. This is an intentional safety feature designed to protect your account from accumulating repeated moderation strikes in quick succession.
What to Do Next
If your queue halts due to a rejection:
- Check the Log Panel: Look at the bottom right log panel to identify the exact name of the asset that was rejected.
- Review the File: Listen to the file and assess why it might have been flagged.
- Remove or Replace: Remove the rejected file from your source folder (or from the queue UI), or edit it to comply with Roblox guidelines.
- Restart: You can safely restart the upload process. The app will skip files that were already successfully approved in the previous run.
3. Surviving App Restarts
If you close the application while assets are still in the "Reviewing" state, you do not need to re-upload them.
The application maintains a local tracking file called pending_moderation.json. When you restart the app, the background poller automatically reads this file, resumes tracking the pending assets, and completes their post-upload steps (like permission granting and DataStore sync) as they get approved.
About pending_moderation.json: This file simply stores the asset IDs that the poller is currently tracking. It contains no secrets, and it is completely safe to add it to your .gitignore file.
4. Prevention Tips
The best way to handle rejections is to avoid them entirely. Before adding files to a large upload batch, ensure they do not contain:
- Explicit lyrics, profanity, or discriminatory language.
- Overly loud or distorted audio intended to bypass volume limits.
- Copyrighted commercial music for which you do not have the proper licenses or rights.
Always adhere to the Roblox Community Standards regarding audio uploads.