Quick Answer
Most common cause: Role hierarchy is wrong.
The LaunchPass bot role must be:
At the very top of your role list
Above all other roles (including admin roles)
Set as Administrator in permissions
If the role is not #1, the bot cannot kick members.
Why This Happens
How Discord Role Hierarchy Works
Discord uses a top-down hierarchy for roles.
The rule:
Higher roles can manage lower roles
Lower roles cannot manage higher roles
If bot role is below member role, bot cannot remove them
Example of broken hierarchy:
Server Owner
Admin
Moderator ← Member has this role
LaunchPass Bot ← Bot is here
Premium Member
@everyone
Bot cannot kick the member because Moderator role is above bot role.
Correct hierarchy:
LaunchPass Bot ← Must be here
Server Owner
Admin
Moderator
Premium Member
@everyone
Now bot can kick anyone because it's at the top.
How to Fix It
Step 1: Enable Administrator Permission
In your Discord server:
Click server name dropdown
Select "Server Settings"
Click "Roles" in the left menu
Find "LaunchPass" role
Click on it
Scroll down to "Permissions"
Scroll all the way to bottom
Toggle "Administrator" to ON (green)
Click "Save Changes"
Why Administrator permission:
Gives bot full control
Can manage all members
Can assign/remove roles
Can kick members
Simplest solution
Step 2: Move LaunchPass Role to Top
Still in Server Settings → Roles:
Look at your role list
Find "LaunchPass" role
Click and drag it to the very top
It should be position #1
Above ALL other roles
Save changes
Visual check:
LaunchPass should be first role in list
Above your admin roles
Above your moderator roles
Above your paid member roles
Above everything except server owner
Step 3: Refresh LaunchPass Dashboard
After fixing Discord settings:
Go to your LaunchPass dashboard
Refresh the page in your browser
This ensures LaunchPass sees the changes
Connection updates
Step 4: Test It Works
Verify the fix:
Option 1: Cancel a test subscription
Create test subscription
Cancel it immediately
Member should be kicked from Discord
Happens within a few minutes
Option 2: Check existing cancelled members
If they're still there, manually remove them
Bot only auto-kicks new cancellations going forward
Old members who joined during broken setup stay
Common Issues and Solutions
Issue 1: LaunchPass Role Not at Top
Problem: Bot role is below other roles.
Fix:
Server Settings → Roles
Drag LaunchPass to position #1
Must be above all other roles
Save changes
Why it matters: Bot can only manage roles below it in the hierarchy.
Issue 2: Administrator Permission Not Enabled
Problem: Bot doesn't have Administrator permission.
Fix:
Server Settings → Roles → LaunchPass
Scroll to bottom of permissions
Toggle Administrator ON
Save changes
Why it matters: Without Administrator, bot may lack specific permissions needed to kick members.
Issue 3: Free Members Joined During Broken Setup
Problem: Members who joined while role hierarchy was wrong don't get auto-removed.
Fix:
Manually remove these members using Discord
Bot will only auto-kick new cancellations going forward
Past issues don't auto-resolve
How to manually remove:
Right-click member name
Select "Kick [username]"
Confirm kick
Issue 4: Wrong Role Selected in LaunchPass Settings
Problem: The "Role to assign" setting in LaunchPass points to wrong role.
Fix:
Log into LaunchPass dashboard
Go to your invite page settings
Check "Role to assign" dropdown
Make sure correct role is selected
Save if changed
Why it matters: If wrong role is selected, bot may not know which role to remove when members cancel.
Issue 5: Role Was Deleted or Renamed
Problem: The role LaunchPass was using got deleted or renamed in Discord.
Fix:
Identify which role was linked to your LaunchPass page
In LaunchPass dashboard, delete the affected invite page
Recreate the page with new/correct role
Don't worry - active subscriptions are not affected
Why this works: Recreating the page refreshes all role associations.
Checking Your Current Setup
Quick Diagnostic
Answer these questions:
1. Is LaunchPass role at the very top?
Check: Server Settings → Roles
Look: Is it position #1?
If no: Move it to top
2. Does LaunchPass role have Administrator?
Check: Click LaunchPass role → Permissions
Scroll: To bottom of list
Look: Is Administrator toggled ON?
If no: Enable it
3. Are cancelled members actually cancelled?
Check: Your Stripe dashboard
Verify: Subscription status is "Canceled"
Sometimes: They may still have access until period ends
4. How long ago did they cancel?
Auto-kick: May take a few minutes
Grace period: Check your settings
Immediate: Or end of billing cycle
If all settings are correct and members still aren't kicked, contact [email protected].
Understanding Auto-Kick Behavior
When Members Get Kicked
By default, members are kicked when:
Subscription cancels
Payment fails after all retries
Refund is issued
Trial expires without payment
Timing:
Usually within a few minutes of cancellation
May be delayed if Discord is slow
Check #launchpass channel for notifications
When Members Keep Access
Members may keep access if:
They cancelled but billing period hasn't ended yet (access until period end)
You have grace period enabled (they get extra time)
dontKickOnCancel is enabled (removes role but doesn't kick)
Bot doesn't have proper permissions (the problem this article fixes)
Alternative: Remove Role Instead of Kicking
If you don't want to kick members:
Use the dontKickOnCancel command in your #launchpass channel.
What this does:
Members stay in your Discord
But their paid role is removed
They lose access to premium channels
They can still see public/free channels
To enable:
Go to your #launchpass channel
Type:
dontKickOnCancelBot responds:
dontKickOnCancel: true
To disable (go back to kicking):
Type the command again:
dontKickOnCancelBot responds:
dontKickOnCancel: false
Preventing Future Issues
Best Practices
✅ Keep LaunchPass role at top always
Check it monthly
After adding new admin roles
After any role changes
Make it a habit
✅ Don't create roles above LaunchPass
When adding new staff roles
Place them below LaunchPass
Maintain hierarchy
✅ Test after changes
Any time you adjust roles
Create test subscription and cancel it
Verify auto-kick works
Catch problems early
✅ Monitor #launchpass channel
Check for notifications
Watch for errors
Bot will report issues
Stay informed
✅ Train your team
Admins should know about hierarchy
Don't move LaunchPass role down
Don't disable Administrator permission
Document the setup
What If It's Still Not Working?
Additional Troubleshooting
Try these steps:
1. Disconnect and reconnect Discord
In LaunchPass dashboard
Disconnect your Discord server
Reconnect it
Reauthorize permissions
Test again
2. Check for Discord outages
Visit Discord status page
Sometimes Discord has issues
May cause delays
Wait and retry
3. Verify bot is in your server
Look for LaunchPass bot in member list
If missing, reconnect Discord
Bot must be present to kick members
4. Check bot is online
LaunchPass bot should show as online (green)
If offline (gray), there's a connection issue
Contact support
5. Review your LaunchPass settings
Check auto-kick is enabled (not using dontKickOnCancel)
Verify grace period settings
Check all invite page configurations
When to Contact Support
Contact [email protected] if:
LaunchPass role is at top with Administrator permission
Bot is online and present in server
Members still aren't getting kicked after cancellation
You've tried all troubleshooting steps
Issue persists for more than 24 hours
Include in your message:
Your Discord server name
Screenshot of role hierarchy
Screenshot of LaunchPass role permissions
Example of member who should have been kicked but wasn't
Their Discord username and email
Response time: Usually within 24 hours on business days.
Quick Reference
Fix Checklist
✅ LaunchPass role at very top of role list
✅ LaunchPass role has Administrator permission enabled
✅ Saved changes in Discord
✅ Refreshed LaunchPass dashboard
✅ Tested with new cancellation
✅ Manually removed old members who joined during broken setup
Role Hierarchy Reminder
Correct order (top to bottom):
LaunchPass Bot ← Must be #1
Your admin/owner roles
Moderator roles
Paid member roles
Other roles
@everyone
Commands to Know
In #launchpass channel:
dontKickOnCancel Toggle between kicking and role removal only
Bot responds:
true= Don't kick, just remove rolefalse= Kick member from server (default)
Related Articles
How Do I Fix Discord Missing Permissions Error - Related permission issues
What is the #launchpass Channel? - Bot commands and notifications
When Using Discord, Do You Assign a Role? - How role assignment works
Configuring Your Discord Server - Complete Discord setup
