# Registration-based Email Verification

Learn how to set up per-application email verification for newly registered users.

> For the index of this section of the site, see [llms.txt](https://fusionauth.io/docs/llms.txt)

Caution

Deprecated since `1.59.0`

The registration verification feature will be removed in a future version of FusionAuth.

FusionAuth provides an email verification flow out of the box. It is an email sent to the user with a link that contains a verification code. When the user clicks on the link, the verification code is checked against the database. If the code is correct, the user's email is marked as verified.

This feature requires that you have an email server available with SMTP support. You can use your own hosted SMTP server, or a third-party SMTP provider such as Amazon SES or SendGrid.

Caution

This document covers setting up verification of users' email based on the application they are registering for. Often you are running multiple applications and some require email verification and others do not.

If you want every user in a tenant to verify their email address or phone number, you can configure this behavior at the tenant level rather than the application level.

Many of the principles are the same, but different templates can be used.

*   [Configure the Tenant Email Server](#configure-the-tenant-email-server)
*   [Configuring Registration Verification Settings](#configuring-registration-verification-settings)
*   [View a User's Verification Status](#view-a-users-verification-status)

## Configure the Tenant Email Server

To send emails, you will need to configure SMTP email server credentials for your tenant. Log in to the FusionAuth Admin UI.

Navigate to Tenants -> Your Tenant and then select the Email tab. Scroll to the SMTP settings section. Configure this with your SMTP server information. If you are testing locally, you can use a mock email server like [MailCatcher](https://mailcatcher.me/).

![Tenant Configuration - SMTP settings](https://fusionauth.io/img/docs/screenshots/tenant-smtp-settings.png)

Ensure a test email is delivered. If you have any issues, follow the steps in the [email troubleshooting documentation](https://fusionauth.io/docs/deploy/troubleshoot/troubleshooting.md#troubleshooting-email).

You can learn more about the various settings in [the Tenant documentation as well](https://fusionauth.io/docs/concepts/types/tenants.md#email).

Save the configuration.

## Configuring Registration Verification Settings

You can configure additional settings around registration verification in the application you set up for registrations. Navigate to Applications -> Your Application and then select the Registration tab. Scroll up to the Registration Verification Settings section, just above the Registration Fields section.

Here you can specify if a registration verification email should be sent to the user. Toggling the **Verify registrations** switch on will reveal some further options.

You can choose the email template to send for registration verification. Choose the `Email Verification` template.

For the **Verification Strategy** option, you can choose to send a link in the verification email to the user, or to send a short code that they can type into the registration form to verify their account.

If you choose to send a short code, you must also set the **Unverified behavior** option to `Gated`. Note that the `Gated` behavior option, and thus the short code option, is only available with a valid license key. Please visit [our pricing page](https://fusionauth.io/pricing.md) to review paid plan options and buy a license.

Your verification settings should now look like this:

![The application Registration tab with registration verification and unverified registration deletion enabled.](https://fusionauth.io/img/docs/screenshots/manage-verification-application-registration-delete.png)

Save all changes to the application.

## View a User's Verification Status

Navigate to the Users page. Click the Manage User button to the right of a list entry to view the user's details. A green checkmark will show next to the user's email address if it has been verified.

![The user details page with a verified email address.](https://fusionauth.io/img/docs/screenshots/manage-verification-verified-user.png)

Note

This shows the the verification status of the user at the tenant level, not the registration level.

Related

[APIs Verify a User's Email API API documentation for the FusionAuth Verify a User's Email API. verify emailemail verification](https://fusionauth.io/docs/apis/users/verify-email.md)

[Users Gate Users Until They Verify Their Email Learn how to gate users' email accounts until they have been verified. email verificationverify email](https://fusionauth.io/docs/users/verify/gate-accounts-until-user-email-verified.md)

[Users Identity Pre-Verification Using Email Verification Form Learn how to verify email identities before user creation with hosted pages. email verificationregistration verification](https://fusionauth.io/docs/users/verify/identity-pre-verification-using-email.md)

[APIs Resend a User Registration Verification Email API API documentation for the FusionAuth Resend a User Registration Verification Email API. registration verification](https://fusionauth.io/docs/apis/registrations/resend-a-user-registration-verification-email.md)
---

## Other pages in Verify

> For the full index of this section, see [Users](https://fusionauth.io/docs/llms-users.txt).

- [Gate Users Until They Verify Their Email](https://fusionauth.io/docs/users/verify/gate-accounts-until-user-email-verified.md): Learn how to gate users' email accounts until they have been verified.
- [Gate Users Until They Verify Their Phone](https://fusionauth.io/docs/users/verify/gate-accounts-until-user-phone-verified.md): Learn how to gate users' phone numbers until they have been verified.
- [Identity Pre-Verification Using Email Verification Form](https://fusionauth.io/docs/users/verify/identity-pre-verification-using-email.md): Learn how to verify email identities before user creation with hosted pages.
- [Identity Pre-Verification Using Phone Verification Form](https://fusionauth.io/docs/users/verify/identity-pre-verification-using-phone.md): Learn how to verify phone identities before user creation with hosted pages.
- [Identity Pre-Verification Via API](https://fusionauth.io/docs/users/verify/identity-pre-verification-via-api.md): Verify email or phone identities entirely via API without using hosted pages.
- [Gate Users Application Registration](https://fusionauth.io/docs/users/verify/registration-gate-accounts-until-verified.md): Learn how to gate users on the application level until they have been verified.
