Netlify Docs
Ask Netlify

Contact

Site & team management /Security /Secure access to sites /Authenticate with Identity /

Manage existing Identity users

Netlify Identity is deprecated

Netlify Identity service and the underlying GoTrue API are deprecated. While Identity and GoTrue continue to function for sites that currently have them enabled, new Identity or GoTrue configurations are not recommended. While we will keep fixing any major security issues that arise, we will no longer fix bugs in the functionality of Identity or GoTrue.

  • For help migrating, existing users can reach out to Support to help you export a list of your users
  • For an alternative to Netlify Identity, we suggest using Auth0. Learn more in our Auth0 extension docs.
  • For an alternative to GoTrue, we suggest Supabase Auth, which is an actively maintained fork of GoTrue.

You can access and manage settings for an individual Identity user.

  1. Navigate to the
    Site configuration Identity Users
    section for your site.
  2. Select an individual Identity user entry from the list.

# User password recovery

From an individual Identity user page, use Send reset password email to trigger an email to the user, following the password recovery email template. The .ConfirmationURL variable in that email will include your site address with a recovery_token appended. The Netlify Identity widget will handle this link automatically, or you can develop a custom password reset form with gotrue-js.

# User account metadata

Information stored in this section will be set in the Identity user object on the /user endpoint in the GoTrue API (accessible with auth.currentUser() in gotrue-js). You can edit these fields by selecting Edit settings on an individual Identity user page:

  • Name: Identity user editable; set under "user_metadata": {"full_name": "Jessica Jones"}
  • Email: Identity user editable; triggers email change confirmation email; changes Identity user login credentials; set under "user_metadata": {"email": "jessica@aliasinvestigations.com"}
  • Roles: not Identity user editable; you can assign one or more roles of your choosing, then use them to control access to areas or functionality in your site by checking this property: "app_metadata": {"roles": ["investigator", "photographer"]}. You can also use these roles with other Netlify services, like Git Gateway and role-based access control.

← Audit log →