Troubleshooting

Ranking says authorize / connect first

Open your group in the dashboard and click Connect Roblox Cloud as the group owner, then try again. Details: Connect Roblox Cloud.

Roblox Cloud banner stays Required / connect fails

• Approve with the Roblox account that owns the group, not a co-owner or alt used only for verify.
• Finish the Roblox consent screen; closing the tab early leaves Cloud disconnected.
• If it was Active before, use Reconnect after revoking the app on Roblox or changing ownership.

Cannot link the group

• Link the Roblox account that owns the group.
• Select the group from Licenses or Add group. Confirm it is not already linked to another license.

Discord roles not updating

• Move the RankForge bot role above the roles it manages.
• Member must be verified; run /update.
• Check binds in the group dashboard.

Forge API returns 403

Your key may be expired, revoked, or tied to a different group. Renew in the store and confirm the group ID in the request.

Apply / staff submit rejected

• Applicants must be signed in with Discord and have linked Roblox (verify / Link Roblox) before submitting.
• Staff proxy submit fails if the target Roblox user has no verified Discord link. Ask them to verify first, or use the public apply page.

Slash command missing or “no permission”

• Confirm the bot is in the server and /setup was run for this guild.
• Staff actions need the matching permission on your Discord role map. See Staff ceilings.
• You cannot moderate or rank someone at or above your max rank.
• Full command list: Discord commands.

Rank or API call is slow or returns 502

• RankForge retries Roblox Open Cloud rate limits and brief outages automatically (up to a few seconds of backoff).
• A Forge API 429 is RankForge's own limit. Wait for Retry-After, then try again.
• Persistent 502 after retries usually means Roblox is still throttling or down; wait and retry with your own backoff.