BotFrame

Discord verification bot template

Turn one clear member action into controlled server access.

Handle a verification button or menu, check the current state, add the approved role, and confirm the outcome through a workflow your moderators can review.

Workflow blueprint

Button or select usedMember has role?Add verified roleSend confirmation

The interaction trigger identifies the member and selected component. A role check prevents redundant work, then the role action grants the configured access and the final step explains what changed.

Configure access deliberately

  • Create the verification message and component in a channel visible to unverified members.
  • Choose a stable Custom ID for the button or select option.
  • Select the exact verified role and review the permissions it grants.
  • Place the bot's Discord role above the verified role so assignment can succeed.
  • Test both an unverified member and a member who already has access.

Nodes used

Security and moderation notes

A one-click role gate proves that the member interacted with the component; it does not prove age, identity, payment, or ownership of an external account. Use it only for the level of assurance it actually provides.

Do not grant administrative permissions through a public verification interaction. Keep the verified role narrowly scoped and review its channel permissions before launch.

Build the verification path

Follow the verification bot guide and test both branches before publishing.