Onboarding

Role Boards

Key features

Button and select role boards

Publish managed Discord messages with buttons or a string select menu so members can self-assign roles.

Option-level eligibility

Gate each option with required roles, denied roles, and minimum member age before Nox changes member roles.

Temporary role grants

Options can grant temporary roles that expire through scheduled cleanup after the configured duration.

Publish, unpublish, and repair

Admins can publish managed board messages, unpublish them, or repair a message by updating the existing Discord message or republishing when it is missing.

Best for

  • Notification roles, topic opt-ins, pronoun roles, platform roles, or event access roles.

  • Access staging where members need prerequisite roles or minimum membership age before selecting a role.

  • Limited-time access for workshops, launches, events, or temporary spaces.

How it works

Create a draft board

Staff configure the channel, message, display mode, selection mode, options, role grants, eligibility rules, emoji, and optional temporary duration.

Publish the managed message

Nox sends the board message with Discord components and stores the channel and message id for later patch, repair, or unpublish.

Members use components

Button or select interactions resolve the board and option, check eligibility, and apply the configured Discord role changes.

Temporary grants expire

When an option grants a temporary role, Nox records the grant and schedules removal. Nox removes the role when the grant expires.

Setup checklist

  • Choose a publish channel where Nox can view, send, embed, and manage the board message.

  • Add at least one option and no more than 25 options.

  • Give every option at least one granted role and review required or denied roles.

  • Confirm Nox has Manage Roles and is above every role it should add or remove.

  • Use temporary role durations from 1 minute to 30 days when temporary access is required.

Important notes

  • Role Boards do not provide member slash commands, Discord modals, reaction handlers, webhooks, or public routes.

  • Editing a published board patches or republishes the managed Discord message and preserves publish state where possible.

  • Stale component interactions return missing-board copy rather than mutating roles.

  • Temporary grants are recorded only after the role is successfully applied. If the role add fails, no expiry job is recorded for that failed grant.

  • Optional emoji are validated and deduplicated per board option before Discord component payloads are built.

Troubleshooting

Members cannot select a role

Check option eligibility, required roles, denied roles, minimum member age, and whether the board or option still exists.

Role assignment fails

Confirm Nox has Manage Roles and is above the target role. Discord hierarchy failures prevent the role mutation.

The board message is missing or stale

Use Repair to fetch and patch the existing message or republish when the stored Discord message is gone.

Permissions

Discord permissions Nox needs for this feature and what each permission is used for.

Required feature permissions

View Channels

Required to post Role Boards in their channels.

Send Messages

Used to publish and update Role Board messages.

Embed Links

Used to publish Role Boards with rich embeds.

Manage Roles

Used to assign and remove member roles from Role Boards.