Skip to main content

Email Verification

The Email Verification tab allows administrators to monitor and manage the email verification status of all users on the platform. From this tab, you can view verification states, resend verification emails, manually verify or unverify users, and manage pending email change requests.

Overview​

The tab displays a table of users with their email verification details. It supports search, status filtering and pagination. The page opens with the title Email verification and the number of matching users, with a help button and Refresh on the right. Verify and unverify open a dialog that asks for a reason; resending a link applies at once.

Search and Filtering​

The search input supports finding users by username, email, or name. Search is debounced to reduce unnecessary API calls while typing.

Status Filter​

The Status filter chip, next to the search box, narrows the user list by verification status. While it is unset, all users are shown regardless of verification status. Its menu offers:

Filter ValueDescription
VerifiedShows only users whose email has been verified
UnverifiedShows only users who have not yet verified their email
Pending verificationShows users who have been sent a verification email but have not yet confirmed

The filter applies as soon as you pick a value; there is no Apply button. Click the x on the chip to clear it. Changing the search or the status returns the list to its first page.

User Table​

The table displays the following columns:

ColumnDescription
UserThe user's login username, their display name below it, and the user ID as a short chip (for example 690078...0001). Click the chip to copy the full ID.
EmailCurrent email address, shortened with an ellipsis when it is too long for the column. If a pending email change exists, the new email is shown below with an arrow indicator. Blank for an account created through an OAuth provider that did not assert a verified email - that account has no email on file and signs in through its provider
StatusStatus chip indicating the current state (see Status Indicators below)
VerifiedDate and time the email was verified, or a dash if not yet verified
Last sentDate and time the last verification email was sent, or a dash
Link expiresExpiration date and time of the verification link, or Expired with the date once it has passed

The last cell of each row holds a ... button that opens the row's actions (see Actions below). On a narrow window the table keeps its columns and scrolls sideways inside its own frame instead of squeezing them.

Status Indicators​

The status column uses status chips to indicate the user's current verification state:

StatusColorCondition
VerifiedGreenEmail has been successfully verified
PendingAmberVerification email sent but not yet confirmed, token still valid
ExpiredRedVerification email was sent but the token has expired
Not sentGrayNo verification email has been sent to this user
Changing emailIndigoUser has a pending email change request

Actions​

Open a row's menu (...) to see its actions. The available actions depend on the user's current verification state:

For Unverified Users​

ActionDescription
Verify emailManually mark the email as verified without requiring the user to click a verification link
Resend verification emailSend a new verification email to the user's current email address

For Verified Users​

ActionDescription
Unverify emailRevoke the verified status, requiring the user to verify their email again

For Users with Pending Email Changes​

ActionDescription
Resend email change linkResend the email change verification to the user's pending new email address

Verify and Unverify Dialog​

Verify email and Unverify email open a dialog before anything changes. The dialog displays:

  • The action being performed (Verify email or Unverify email)
  • The affected user's email and username
  • For unverify, a note that the user will have to verify the address again
  • A reason: pick a preset or write a note of at least 5 characters. The reason is recorded with the change. Verify offers Ownership confirmed by support and Internal testing; Unverify also offers Bounced or invalid address.
  • Cancel and confirm buttons (the confirm button is red for unverify)

Resend verification email and Resend email change link apply as soon as you pick them, with no confirmation step, and a toast confirms the send. While a send is in progress, the same item in that row's menu is disabled and reads Sending verification email or Sending email change link, so a second click cannot send twice.

Pagination​

The table has one pager, in its footer:

SettingValues
Rows per page25 (default), 50, 100
NavigationPrevious and next arrow buttons
RangeDisplayed as "1 to 25 of N", where N is the number of matching users (also shown beside the page title)

While the next page loads, the current rows stay on screen.

Refresh​

The Refresh button in the page header reloads the verification data from the server. It is disabled while data is being fetched. If the list fails to load, a Try again button appears in place of the rows.

Error Handling​

When an action fails, the error message from the backend is displayed as a toast notification. The data is automatically refreshed after an error to reflect any backend state changes (such as an expired token being automatically cancelled).

Best Practices​

  • Use the Pending verification filter to identify users who may need a reminder or manual verification.
  • Check the Link expires column before resending -- if a token is still valid and not expired, consider waiting before resending.
  • Use manual verification sparingly and only for cases where the user cannot receive email (such as email delivery issues).
  • The Unverify action should be used cautiously, as it requires the user to go through the verification process again.
  • Monitor the Changing Email status to ensure email change requests are completing successfully.