FAQ (Technical)
Why does the bot say “This server is pending approval”?
The bot is configured to require manual approval for new servers. The operator must approve your server (and, in subscription mode, set a duration) via the DM they received when you added the bot. Until then, setup and other approval-gated commands will not work.
Why can’t the bot assign the VIP role?
The bot’s role must be above the VIP role in Server Settings → Roles. Discord only allows a bot to assign roles that are below its highest role. Move the bot’s role above the VIP role and try again.
What format are keys?
Keys are 6 characters (letters/numbers). Users enter them in the Redeem Key modal. Keys are one-time use per server; after redemption the key is marked used and the user gets the VIP role for the configured duration (e.g. 1 hour).
Where do keys come from?
Keys are created by your external key generator (the URL you set in /setup as the “Link”). KeyHub does not generate keys; it only validates and redeems them. Your generator must integrate with the same backend/database that KeyHub uses so that keys are valid when pasted in Discord.
Can I change the key channel or log channel after posting?
Yes. Run /setup again and use Set Channel / Set Log to pick new channels, then press Post. The embed will be updated or moved to the new key channel; you may need to remove the old message manually if the bot doesn’t edit it in place.
What happens when a server subscription expires?
The key channel embed is updated to a “subscription expired” state: Generate Key and Redeem Key are disabled. Users cannot redeem until the server is renewed (operator uses /renew and approves with a new duration).
What happens when a user’s VIP time expires?
The bot removes the VIP role from the user and can post a message in the log channel. The user must redeem a new key to get the role again.
Why don’t I see DM-only commands in my server?
Commands like /remove, /subscriptions, /setting, and /renew are registered as DM-only. They appear only when you open the bot’s DM and use the slash command menu there. They are restricted to the configured developer user ID.