Cooldown

Cooldown prevents users from repeatedly triggering the verification flow in a short time span.

Why it matters

Without a cooldown, users can retry too quickly after failure or repeatedly trigger your verification logic in ways that create noise.

What cooldown protects against

  • Rapid re-attempt spam
  • Repeated role churn
  • Extra noise in verification logs

When to enable it

Enable cooldown when:

  • Verification abuse is common
  • You want a more stable review window after a failed attempt
  • You also use maximum verifications per user

Practical guidance

  • Keep the cooldown long enough to discourage spam.
  • Keep it short enough that legitimate users are not locked out for too long after a mistake.
  • Document the policy in your rules if it affects normal onboarding.