Docs Features Guide Registration System

Registration System

Member verification and registration with four modes: interactive staff-driven, button self-register, verification gate, and voice registration

registration verification welcome button interactive voice staff role panel age

Overview

The registration system controls how new members gain access to your server. Navigate to Left sidebar > Registration on your server dashboard to configure all settings. Four registration modes are available: Interactive (staff-driven registration with approve/jail buttons), Button (members click a button to self-register), Verification (members complete a verification step), and Voice (members join a voice channel to register). Each mode has its own set of configuration fields. The mode is locked after initial setup and cannot be changed without resetting.

Enabling and General Settings

Toggle the enabled switch at the top of the Registration settings page to activate the module. These general settings apply across all modes:

mode (select dropdown): Choose between interactive, button, verification, or voice_registration. This determines the registration flow and which settings sections are available below.

channelId (channel picker): The main channel used for registration activity.

logChannelId (channel picker): A channel where registration events are logged, such as new registrations, staff actions, and errors.

chatChannelId (channel picker): The channel where the member is redirected or welcomed after successful registration. Required when the module is enabled.

registeredRole (role picker): The role assigned to members upon successful registration, granting them access to the server.

unregisterRole (role picker): A role assigned to unregistered members, typically restricting channel access until registration is complete.

staffRole (role picker): The role that grants permission to manage registrations in interactive mode.

Age and Name Settings

Configure member identity formatting and age requirements:

minAge (number input, default 13, minimum 13): The minimum age required to register. Members below this age will be rejected.

nameFormat (text input, max 120 characters, default '{user} | {age}'): The format used to set the member's server nickname after registration. Supported placeholders: {user} for the member's display name, {age} for their stated age.

tag (text input, max 24 characters): A clan tag or community tag prepended to the member's nickname. For example, setting this to 'RC' would format names as 'RC | Username'.

enableTag (toggle): Enable or disable the tag prefix in nickname formatting.

Interactive Mode

Interactive mode requires staff members to manually approve or reject each new member. When a member joins, a panel appears in the registration channel with staff action buttons.

registrationChannelId (channel picker): The channel where new member registration panels appear for staff to review.

unregisteredRoleId (role picker): Role assigned to new members before registration, restricting their access.

registeredRoleId (role picker): Role assigned after staff approves the registration.

staffRoles (multi-role picker): Roles that can interact with registration panels to approve or jail members.

autoName (toggle): Automatically set the member's nickname using the nameFormat template after approval.

autoRole (toggle): Automatically assign the registered role without staff clicking a button.

allowSelfRegister (toggle): Allow members to register themselves without staff interaction.

requireAge (toggle, default true): Require members to provide their age during registration.

panelTitle (text input, max 120 characters, default 'New Member Joined'): The title of the registration panel embed that appears for staff.

panelDescription (text input, max 1200 characters, default 'Welcome {user}! Use the controls below for registration.'): The description text in the registration panel embed.

joinButtonLabel (text input, max 80 characters, default 'Normal Register'): The label on the approve/register button.

jailButtonLabel (text input, max 80 characters, default 'Send To Jail'): The label on the jail button for suspicious members.

chatSuccessMessage (text input, max 1200 characters): A custom message sent to the chat channel when a member is successfully registered.

Button Mode

Button mode lets members self-register by clicking a button on a panel embed. No staff interaction is required.

channelId (channel picker): The channel where the registration panel with the button is posted.

roleIds (multi-role picker): One or more roles assigned to the member when they click the register button.

panelTitle (text input, max 120 characters, default 'Member Registration'): The title of the panel embed.

messageContent (text input, max 1800 characters): Additional text content displayed above the embed in the panel message.

buttonLabel (text input, max 80 characters, default 'Register'): The label on the registration button.

buttonEmoji (emoji picker, default '✅'): The emoji displayed on the registration button.

chatSuccessMessage (text input, max 1200 characters): A custom message sent after successful registration.

Verification Mode

Verification mode adds a verification step before granting access. Members click a verify button to prove they are not a bot.

channelId (channel picker): The channel where the verification panel is posted.

roleId (role picker): The role assigned upon successful verification.

panelTitle (text input, max 120 characters, default 'Verification Center'): The title of the verification embed.

panelDescription (text input, max 1200 characters, default 'Complete verification to access member channels.'): The description text explaining the verification process.

buttonLabel (text input, max 80 characters, default 'Verify'): The label on the verify button.

chatSuccessMessage (text input, max 1200 characters): A custom message sent after successful verification.

Voice Registration

Voice registration mode assigns roles when members join a specific voice channel. This is useful for servers that want to verify members can use voice before granting access.

voiceChannelId (channel picker): The voice channel members must join to complete registration.

logChannelId (channel picker): A channel for logging voice registration events.

chatSuccessMessage (text input, max 1200 characters): A custom message sent after successful voice registration.

Publishing the Panel

After configuring your settings, click the Publish Panel button on the dashboard to send the registration panel embed to the selected channel. This applies to button, verification, and interactive modes. The panel includes the configured title, description, and action buttons. If you change panel settings after publishing, you will need to republish the panel for the changes to take effect in the Discord channel. The old panel message will remain — you can delete it manually.

Tips

For small to medium servers, button mode provides the simplest setup with minimal configuration. For servers that need to screen new members, interactive mode gives staff full control over who gains access. Enable requireAge in interactive mode if your server has age-restricted content. Use the verification mode as a lightweight anti-bot gate. Set up the logChannelId to track all registration activity and identify issues. The nameFormat field with {user} and {age} placeholders helps maintain consistent member naming across your server.