VerifyGate Tutorial guide
Back to main
πŸ‡±πŸ‡Ή LietuviΕ³

πŸ€– Discord Survey System

Simple guide: how to use survey system in Discord server

What is this?

Discord Surveys

Users fill surveys in their private Discord channel. Automatically created, automatically managed.

Web Management

Administrators create questions and manage settings via convenient web interface. Answer approval happens in Discord.

Auto Approval

Bot sends answers to Discord admin channel. Admins approve or reject members with one button click.

Important Rule

Each user can have only ONE active survey at a time. After completion, can start a new one.

How to use the bot

What is done automatically for you?
  • Private channel creation - bot creates channel for each user
  • Role management - roles are automatically assigned/removed
  • Timeout system - survey automatically deleted after time
  • Spam protection - can't start multiple surveys simultaneously
  • Data storage - all answers are safely stored
  • Admin notifications - notification to admin channel about new survey
  • Category organization - channels created in appropriate categories
  • Cleanup - old channels/data can be cleaned with command
Admin commands in Discord
  • !survey_setup - Creates whole system (categories, channels, roles)
  • !survey_status - Shows system status and active survey count
  • !survey_cleanup - Cleans old surveys and inactive channels
  • !survey_reset - Reloads whole system (careful!)
  • !help - List of all commands with explanations
  • !language - Changes language (LT/EN)
  • !settings - Server settings and configuration
How to refresh the welcome message

Follow these steps to push the edited text to Discord:

  • Brand new server: edit the text inside the Survey Welcome Message card, hit Save, then run !survey_setup. The Discord channel will be created with the new text.
  • If the channel already exists, run !survey_setup again after saving. This recreates the survey channel message with the updated wording.
Admin control buttons (Discord admin channel)
APPROVE (Approve)
  • Assigns roles to user based on server settings
  • Sends approval message to user
  • Cleans private channel after approval
  • Marks survey status as "approved"
REJECT (Reject)
  • DOES NOT assign roles to user
  • Sends rejection message with reason
  • Cleans private channel after rejection
  • Marks survey status as "rejected"
DELETE CHANNEL (Delete Channel)
  • Deletes private channel and all messages
  • Does not affect roles - channel cleanup only
  • Use when survey incomplete or timeout
  • Data remains in system for analytics
DELETE MESSAGE (Delete Message)
  • Deletes admin notification about survey
  • Does not affect survey data or channels
  • Keeps admin channels clean
  • Cosmetic action - message only
IMPORTANT: Button effects
  • πŸ“‹ Debug info shows: response count, question count
  • βœ… Approve = roles + message + cleanup
  • ❌ Reject = message + cleanup (no roles)
  • πŸ—‘οΈ Delete Channel = channel cleanup only
  • πŸ’¬ Delete Message = message cleanup only
  • ⚠️ Actions irreversible - think before clicking
What you DON'T need to do yourself?
  • ❌ Create private channels - bot does automatically
  • ❌ Manage roles - bot assigns/removes based on survey results
  • ❌ Delete old surveys - there are cleanup commands
  • ❌ Track timeout times - system tracks itself
  • ❌ Program questions - use web interface
  • ❌ Manually check answers - admin panel shows everything
  • ❌ Create databases - bot creates automatically
  • ❌ Write documentation - everything is explained in Discord
Where to get help?

Everything is explained in Discord! No need for any documentation or guides - just use !help command and bot will show all possibilities with explanations. Bot answers questions, shows examples and helps configure.

Bot invitation: You don't need to create or configure anything - I am the bot creator and can invite it to your server with all functional capabilities.

How to start using? (Step by step)

1
Bot invitation

Contact bot creator - no need to install or create anything. Bot will be invited to your server with all functions.

2
System setup

Execute !survey_setup command in Discord. Bot will automatically create categories, channels and roles.

3
Web interface

Go to web interface (localhost:5000) and create survey questions. Simple form - no programming knowledge needed.

⚠️ CRITICAL: Bot Role Hierarchy

Bot MUST be higher than all roles it assigns!

  • Discord Server Settings β†’ Roles β†’ Move bot role ABOVE "Verified" and other roles
  • If bot role is too low - role assignment WON'T WORK!
  • Bot cannot assign role that is higher than its own role
  • Correct order: Bot Role β†’ Verified β†’ @everyone
Common mistake: Bot role is below "Verified" role β†’ Approve button doesn't work β†’ Users don't get roles!
4
User surveys

Users can start survey in any server. Bot automatically creates private channel and guides through questions.

5
Admin review

Bot notifies admin channel about new completed survey with all answers. Admins approve/reject directly in Discord using buttons.

6
Automatic result

Based on admin decision bot automatically assigns roles or notifies about rejection. Private channel is cleaned.

How does bot help you?
  • πŸš€ Eases management - no manual work needed
  • ⚑ Quick setup - one command creates everything
  • πŸ›‘οΈ Security - private channel protection
  • πŸ“Š Centralized management - in one web panel
  • πŸ”„ Automatic workflow - from start to finish
  • πŸ—‚οΈ Organization - channel categories and roles
  • ⏰ Timeout control - no hanging surveys
  • 🎯 Focus on content - you create questions, bot does everything else

Why is this better than other solutions?

Traditional solutions (complicated)
  • Google Forms/Docs - need to upload links, force people out of Discord
  • Manual checking - admins have to read somewhere else
  • Manual role assignment - extra work after each survey
  • Multiple places - Discord + Google + Email + something else
  • No automation - everything done by hand
  • Hard to track progress - who completed, who didn't?
This solution (simple)
  • Everything in Discord - users don't need to leave the platform
  • Automatic checking - bot sends answers directly to admin channel in Discord
  • Automatic roles - one button click in Discord and user gets role
  • Simple management - Discord commands + Web panel for creating questions
  • Full automation - just click buttons in Discord admin channel
  • Clear progress tracking - system shows everything real-time
User experience - what they don't need to do
❌ With other solutions:
  • Go to Google Forms
  • Fill form on website
  • Wait for admin email
  • Return to Discord
  • Ask for role manually
  • No clear info about process
βœ… With this bot:
  • Stay in Discord
  • Answer questions right here
  • Get result immediately
  • Automatic role assignment
  • Clear process and instructions
  • Timeout protection - no "hanging" surveys
Main idea: "Seamless Experience"

Users don't need to leave Discord platform! They can fill surveys, get responses, and receive roles - all in the same place. This greatly improves user experience and increases completion rate.

Also simpler for admins: See everything in Discord admin channel, one button click gives result. No need to copy from Google Docs, send emails, manually assign roles - everything is automated.

Survey Types πŸ†• NEW

One server can have multiple separate surveys β€” e.g. medics, police, military. Each type has its own channel, questions, director role and approval channel.

How does it work?
  1. Admin runs !survey_type medics in Discord
  2. Bot automatically creates #medics-survey β€” public channel for members
  3. Bot automatically creates #medics-approvals β€” private channel for directors only
  4. In web interface go to Survey Types β†’ medics β†’ Edit and add questions
  5. Members click "Fill out Survey" button in #medics-survey channel
  6. After completion β€” answers are sent directly to #medics-approvals
Channel structure 
πŸ“ Surveys
  # survey-members    ← general
  πŸ”’ admin-surveys    ← main admin
  # medikai-survey    ← members
  πŸ”’ medikai-approvals ← directors only
  # policija-survey   ← members
  πŸ”’ policija-approvals ← directors only
Discord commands
Command Action
!survey_type medics Creates both channels
!survey_type medics close Closes the survey
!survey_type medics open Opens the survey
!survey_type Lists all types

πŸ’‘ Commands work in both EN and LT versions.

Language support
  • Channel names depend on your language setting
  • πŸ‡ΊπŸ‡Έ EN: #medics-survey, #medics-approvals
  • πŸ‡±πŸ‡Ή LT: #medikai-anketa, #medikai-patvirtinimai
  • Change language: !language en or !kalba lt
Management via Web interface
Types list

See all types, their status and question count

Question editing

Each type has its own question set and welcome message

Open / Close

One click to close or open a specific survey type

In web interface you can set for each type: director role, approved role, approval channel and welcome message.
Important to know
  • Renaming channels won't break the system β€” bot uses channel ID, not name
  • If type is closed (πŸ”΄) β€” members cannot start the survey
  • Each type has its own separate approval channel β€” directors from different departments don't see each other's surveys
  • Types can also be created in the web interface (Survey Types β†’ Create new), not only via Discord command

Limits and Restrictions

Free Version
  • 8 questions maximum per survey
  • 1 survey per user at a time
  • 2 attempts if not completed on time
  • No server monitoring
  • Standard timeout (5 min)
Premium Version
  • 25 questions maximum per survey
  • 6 roles maximum
  • 5 questions per role
  • Automatic server monitoring (Minecraft/FiveM)
  • Additional features
What is NOT ALLOWED
  • Fill multiple surveys at once - system automatically blocks
  • Return to survey after timeout - automatically deleted
  • Use server monitoring without premium
  • Create more than 8 questions without premium (premium: 25 max)
  • Change answers after survey completion

πŸ€– Discord Survey System

Simple, automatic member selection system for your Discord server

Remember: One survey per user, automatic timeout, admin approval!

Limits: Free (8 questions) vs Premium (25 questions)

Why use this bot?

Everything is automated, secure, simple to use and costs no additional resources. Just invite the bot and start using - everything else is done for you!