Discord server onboarding is a built-in feature that helps new members learn about your community and access channels without confusion. Without a proper onboarding flow, new members often ask repetitive questions or miss important rules. The onboarding system replaces the need for a separate welcome bot by providing a guided setup experience. This article explains how to configure the onboarding flow step by step, including custom questions and channel recommendations.
Key Takeaways: Discord Server Onboarding Setup Checklist
- Server Settings > Community > Enable Community: Turns on the onboarding feature and unlocks all related options.
- Server Settings > Onboarding > Default Channels: Sets channels every new member sees before they choose their roles.
- Server Settings > Onboarding > Custom Questions: Lets you ask new members for their name, time zone, or interests to personalize their experience.
What the Discord Server Onboarding Flow Does
The onboarding flow is a guided setup that appears when a new member joins your server. It shows a welcome screen, asks custom questions, and recommends channels based on the member’s answers. This feature is part of the Community server settings and requires you to enable Community mode first. Once enabled, you can design a series of screens that new members see before they can fully interact with the server. The onboarding flow reduces confusion and helps new members feel welcome without overwhelming them.
Prerequisites for using the onboarding flow include having a server with at least two text channels and two voice channels. You must also enable 2FA (two-factor authentication) on your Discord account to enable Community mode. The onboarding flow is available on desktop, web, and mobile apps.
Steps to Set Up the Discord Server Onboarding Flow
Follow these steps to configure the onboarding flow for your server. Each step builds on the previous one, so complete them in order.
- Enable Community Mode
Open your server settings by clicking the server name at the top-left and selecting Server Settings. Go to the Community tab and click Enable Community. Follow the prompts to set a rules channel, a community updates channel, and verify your email if needed. After enabling, the Onboarding tab appears in the left sidebar. - Open the Onboarding Settings
In Server Settings, click Onboarding under the Community section. You will see a toggle labeled Enable Onboarding. Turn it on. A preview of the welcome screen appears on the right side. - Set Default Channels
Under Default Channels, select the channels every new member sees before they complete onboarding. Choose channels like #rules, #welcome, or #announcements. These channels are visible to new members immediately. You can add up to five default channels. - Add Custom Questions
Click Add Question under the Questions section. Type your question in the text field, for example, “What is your time zone?” or “What topics interest you?” Choose whether the answer is required or optional. You can add up to five custom questions. Each question can have a short answer or multiple choice options. - Create Channel Recommendation Prompts
Under Channel Recommendations, click Add Recommendation. This feature suggests channels based on the member’s answers. For example, if a member says they like gaming, recommend a #gaming channel. You can link each recommendation to a specific question answer. Up to 10 recommendations are allowed. - Set Up Role Assignment via Onboarding
In the Onboarding settings, click Roles under the Resource Channels section. Here you can assign roles automatically when a member answers a question. For example, if a member selects “PC Gaming,” assign the PC Gamer role. This step is optional but recommended for large servers. - Preview and Test the Flow
Click the Preview button at the top of the Onboarding page. A simulated welcome screen appears. Test each question and recommendation to ensure they work correctly. You can also create an alt account or use the server invite to test the flow in a private channel. - Save and Publish
After testing, click Save Changes at the bottom of the Onboarding page. The onboarding flow is now active for all new members. Existing members will not see the flow unless they rejoin the server.
Common Mistakes and Limitations to Avoid
The Onboarding Tab Is Missing
If you do not see the Onboarding tab in Server Settings, Community mode is not enabled. Go to Server Settings > Community and complete the setup. You must also have at least two text channels and two voice channels. After enabling Community, restart Discord to refresh the settings.
Custom Questions Appear as Empty
Custom questions that require an answer but have no text will not save. Make sure every question has at least one character in the text field. Also, avoid using special characters like @ or # in the question text, as they may cause display issues.
Channel Recommendations Not Showing
Channel recommendations only appear if you have linked them to a question answer. Go to Onboarding > Channel Recommendations and verify that each recommendation has a trigger condition set. Also, ensure the recommended channel is not already a default channel. If a channel is both default and recommended, it may be hidden from the recommendation screen.
New Members Cannot See the Onboarding Flow
The onboarding flow only appears for new members who join after you save the settings. Existing members do not see the flow. To test, create an invite link that does not grant any roles and join from a different browser or incognito window. Also, check that the Enable Onboarding toggle is turned on.
Role Assignment Not Working
Automatic role assignment requires that the roles are set to be assignable by the onboarding flow. In Server Settings > Roles, edit each role and enable the option “Allow anyone to add this role from the onboarding flow.” Also, the bot or server administrator must have permission to manage roles. If role assignment still fails, remove and re-add the role in the Onboarding > Roles section.
| Item | Without Onboarding | With Onboarding |
|---|---|---|
| New member experience | Sees all channels immediately, often confused | Guided welcome screen with questions and recommendations |
| Custom questions | Not available without a bot | Built-in up to 5 questions |
| Channel recommendations | Must be done manually or via bot | Automatic based on answers |
| Role assignment | Requires separate bot or manual assignment | Built-in role linking to questions |
| Setup complexity | High if using multiple bots | Low, all in one settings page |
The onboarding flow is a powerful tool for making new members feel welcome and informed. By setting up custom questions and channel recommendations, you reduce the workload on moderators and help members find relevant content faster. For advanced customization, consider combining the onboarding flow with server-specific bots that handle role menus or auto-moderation. Test the flow with a few test accounts before launching it to your entire community.