> ## Documentation Index
> Fetch the complete documentation index at: https://auth0-chore-events-autoupdate.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# User Profile Overview

> Manage users in Auth0 with the Dashboard, Management API, and SDKs, including search, import and export, linking, and access management.

Auth0's hosted cloud database stores a variety of information on your users that is accessible to you. This information is available to you via a user profile, and your users are grouped by tenant. The user information itself can come from a variety of sources, including <Tooltip tip="Identity Provider (IdP): Service that stores and manages digital identities." cta="View Glossary" href="/docs/glossary?term=identity+providers">identity providers</Tooltip>, your own databases, and enterprise connections (Active Directory, <Tooltip tip="Identity Provider (IdP): Service that stores and manages digital identities." cta="View Glossary" href="/docs/glossary?term=SAML">SAML</Tooltip>).

## Concepts

<Columns cols={2}>
  <Card title="User Profiles" icon="head-side-gear" href="/docs/manage-users/user-accounts/user-profiles" horizontal>
    Understand how user profiles work in Auth0.
  </Card>

  <Card title="Understand How Metadata Works in User Profiles" icon="head-side-gear" href="/docs/manage-users/user-accounts/metadata" horizontal>
    User profiles have two kinds of metadata (user and application) that let you store information that does not originate from an identity provider.
  </Card>

  <Card title="Normalized User Profile Attributes" icon="head-side-gear" href="/docs/manage-users/user-accounts/user-profiles/normalized-user-profiles" horizontal>
    Understand how Auth0 normalizes common attributes in the user profile.
  </Card>

  <Card title="Email Verification for Users" icon="head-side-gear" href="/docs/manage-users/user-accounts/user-profiles/verified-email-usage" horizontal>
    Outlines proper usage of the email\_verified field in a user profile.
  </Card>
</Columns>

## How To

### Create and Manage Users

<Columns cols={2}>
  <Card title="Create Users" icon="person-chalkboard" href="/docs/manage-users/user-accounts/create-users" horizontal>
    Describes how to create users in the Auth0 Dashboard.
  </Card>

  <Card title="Unlink Devices from Users" icon="person-chalkboard" href="/docs/manage-users/user-accounts/unlink-devices-from-users" horizontal>
    Describes how to unlink devices assigned to a user using the Auth0 Dashboard.
  </Card>

  <Card title="Delete Users" icon="person-chalkboard" href="/docs/manage-users/user-accounts/delete-users" horizontal>
    Describes how to delete users.
  </Card>
</Columns>

### Modify User Profile Attributes

<Columns cols={2}>
  <Card title="How to Set User Profile Attributes During User Import" icon="person-chalkboard" href="/docs/manage-users/user-accounts/user-profiles/root-attributes/set-root-attributes-during-user-import" horizontal>
    Learn how to set attributes for users during import using the Auth0 Management API.
  </Card>

  <Card title="How to Set User Profile Attributes During User Signup" icon="person-chalkboard" href="/docs/manage-users/user-accounts/user-profiles/root-attributes/set-root-attributes-during-user-sign-up" horizontal>
    Learn how to set attributes for users during signup using the Auth0 Management API.
  </Card>

  <Card title="How to Update User Profile Attributes for Existing User Profiles" icon="person-chalkboard" href="/docs/manage-users/user-accounts/user-profiles/root-attributes/update-root-attributes-for-users" horizontal>
    Learn how to update attributes in existing user profiles using the Auth0 Management API.
  </Card>

  <Card title="How to Manage User Profile Metadata" icon="person-chalkboard" href="/docs/manage-users/user-accounts/metadata/manage-user-metadata" horizontal>
    Access and set user and app metadata in user profiles using the Auth0 Dashboard, Management API, or a `post-login` Action.
  </Card>

  <Card title="How to Configure User Profile Attribute Synchronization from Upstream Identity Providers" icon="person-chalkboard" href="/docs/manage-users/user-accounts/user-profiles/configure-connection-sync-with-auth0" horizontal>
    Enable synchronization to update user profile attributes from your external IdP each time users log in or disable synchronization to be able to edit user profile attributes directly.
  </Card>

  <Card title="How to Modify User Profile Attributes from Custom Database Connections" icon="person-chalkboard" href="/docs/manage-users/user-accounts/user-profiles/update-user-profiles-using-your-database" horizontal>
    Learn how to update user profiles when using your own user store as an identity provider.
  </Card>
</Columns>

### View and Search Users

<Columns cols={2}>
  <Card title="Identify Users" icon="person-chalkboard" href="/docs/manage-users/user-accounts/identify-users" horizontal>
    Learn how to uniquely identify users.
  </Card>

  <Card title="View User Details" icon="person-chalkboard" href="/docs/manage-users/user-accounts/view-user-details" horizontal>
    How to view users and their profile details.
  </Card>

  <Card title="How to List and Search Users with Search Queries" icon="person-chalkboard" href="/docs/manage-users/user-search/list-and-search-users" horizontal>
    Retrieve a list of all user profiles and filter results with Lucene search query strings.
  </Card>

  <Card title="How to Get Specific Users by Auth0 ID or Email" icon="person-chalkboard" href="/docs/manage-users/user-search/get-users-by-id-or-email" horizontal>
    Retrieve full user profiles for specific users with a matching email address or Auth0 user ID.
  </Card>
</Columns>

### Verify Emails

<Columns cols={2}>
  <Card title="Verify Emails using Auth0" icon="person-chalkboard" href="/docs/manage-users/user-accounts/verify-emails" horizontal>
    Overview of the different ways to verify user emails using Auth0
  </Card>

  <Card title="Resend Verification Emails" icon="person-chalkboard" href="/docs/manage-users/user-accounts/resend-verification-emails" horizontal>
    Describes how to resend verification emails to users via the Auth0 Management Dashboard and the Auth0 Management API.
  </Card>
</Columns>

### Link Accounts

<Columns cols={2}>
  <Card title="Link User Accounts" icon="person-chalkboard" href="/docs/manage-users/user-accounts/user-account-linking/link-user-accounts" horizontal>
    Understand how to link user accounts from various identity providers, so your users can authenticate from any account and be recognized by your app.
  </Card>

  <Card title="Unlink User Accounts" icon="person-chalkboard" href="/docs/manage-users/user-accounts/user-account-linking/unlink-user-accounts" horizontal>
    Learn how to use the Management API Unlink a User Account endpoint to unlink an identity from the target user account making it a separate user account again.
  </Card>
</Columns>

### Migrate Users

<Columns cols={2}>
  <Card title="Enable Automatic Migration to Auth0 from an External User Store" icon="person-chalkboard" href="/docs/manage-users/user-migration/configure-automatic-migration-from-your-database" horizontal>
    Gradually migrate users from your external user store to Auth0 as they log in by enabling import mode on your custom database connection.
  </Card>

  <Card title="Bulk Import User Data into Auth0 Database Connections" icon="person-chalkboard" href="/docs/manage-users/user-migration/bulk-user-imports" horizontal>
    Migrate users from an existing database or service to Auth0 using bulk imports for database connections.
  </Card>

  <Card title="Bulk Export User Data" icon="person-chalkboard" href="/docs/manage-users/user-migration/bulk-user-exports" horizontal>
    Export supported user profile data from Auth0 into a JSON-compatible or CSV format file.
  </Card>

  <Card title="Export Password Hashes and MFA Secrets" icon="person-chalkboard" href="/docs/manage-users/user-migration/export-password-hashes-and-mfa-secrets" horizontal>
    Request a PGP-encrypted export of password hashes and MFA secrets from your Auth0 tenant through a support case.
  </Card>
</Columns>

### Control Access

<Columns cols={2}>
  <Card title="Manage User Access to Applications" icon="person-chalkboard" href="/docs/manage-users/user-accounts/manage-user-access-to-applications" horizontal>
    Explains the basics of a user profile, how to create a user and view users and their profile details.
  </Card>

  <Card title="Deny User Access to an API with Rules" icon="person-chalkboard" href="/docs/manage-users/user-accounts/deny-api-access" horizontal>
    Learn how to use Auth0's Authorization Extension to deny users access to an API using rules.
  </Card>

  <Card title="How to Block and Unblock Users as a Tenant Administrator" icon="person-chalkboard" href="/docs/manage-users/user-accounts/block-and-unblock-users" horizontal>
    Control a user's ability to log in to your application by adding or removing tenant administrator blocks.
  </Card>
</Columns>

## Reference

<Columns cols={2}>
  <Card title="Auth0 User Profile Attribute Schema" icon="book-bookmark" href="/docs/manage-users/user-accounts/user-profiles/user-profile-structure" horizontal>
    View a reference for Auth0 user profile attributes, including validation requirements and support for features like search and upsert.
  </Card>

  <Card title="User Data JSON Schema for Bulk User Imports" icon="book-bookmark" href="/docs/manage-users/user-migration/bulk-user-import-schema" horizontal>
    View the JSON schema and property descriptions for user data used for bulk imports.
  </Card>

  <Card title="Lucene Query Syntax and Examples for Auth0 User Search" icon="book-bookmark" href="/docs/manage-users/user-search/user-search-query-syntax" horizontal>
    View Lucene query syntax details and examples for Auth0 user search version 3.
  </Card>
</Columns>

## Concepts

<Columns cols={2}>
  <Card title="User Profiles" icon="head-side-gear" href="/docs/manage-users/user-accounts/user-profiles" horizontal>
    Understand how user profiles work in Auth0.
  </Card>

  <Card title="Understand How Metadata Works in User Profiles" icon="head-side-gear" href="/docs/manage-users/user-accounts/metadata" horizontal>
    User profiles have two kinds of metadata (user and application) that let you store information that does not originate from an identity provider.
  </Card>

  <Card title="Normalized User Profile Attributes" icon="head-side-gear" href="/docs/manage-users/user-accounts/user-profiles/normalized-user-profiles" horizontal>
    Understand how Auth0 normalizes common attributes in the user profile.
  </Card>

  <Card title="Email Verification for Users" icon="head-side-gear" href="/docs/manage-users/user-accounts/user-profiles/verified-email-usage" horizontal>
    Outlines proper usage of the email\_verified field in a user profile.
  </Card>
</Columns>

## How To

### Create and Manage Users

<Columns cols={2}>
  <Card title="Create Users" icon="person-chalkboard" href="/docs/manage-users/user-accounts/create-users" horizontal>
    Describes how to create users in the Auth0 Dashboard.
  </Card>

  <Card title="Unlink Devices from Users" icon="person-chalkboard" href="/docs/manage-users/user-accounts/unlink-devices-from-users" horizontal>
    Describes how to unlink devices assigned to a user using the Auth0 Dashboard.
  </Card>

  <Card title="Delete Users" icon="person-chalkboard" href="/docs/manage-users/user-accounts/delete-users" horizontal>
    Describes how to delete users.
  </Card>
</Columns>

### Modify User Profile Attributes

<Columns cols={2}>
  <Card title="How to Set User Profile Attributes During User Import" icon="person-chalkboard" href="/docs/manage-users/user-accounts/user-profiles/root-attributes/set-root-attributes-during-user-import" horizontal>
    Learn how to set attributes for users during import using the Auth0 Management API.
  </Card>

  <Card title="How to Set User Profile Attributes During User Signup" icon="person-chalkboard" href="/docs/manage-users/user-accounts/user-profiles/root-attributes/set-root-attributes-during-user-sign-up" horizontal>
    Learn how to set attributes for users during signup using the Auth0 Management API.
  </Card>

  <Card title="How to Update User Profile Attributes for Existing User Profiles" icon="person-chalkboard" href="/docs/manage-users/user-accounts/user-profiles/root-attributes/update-root-attributes-for-users" horizontal>
    Learn how to update attributes in existing user profiles using the Auth0 Management API.
  </Card>

  <Card title="How to Manage User Profile Metadata" icon="person-chalkboard" href="/docs/manage-users/user-accounts/metadata/manage-user-metadata" horizontal>
    Access and set user and app metadata in user profiles using the Auth0 Dashboard, Management API, or a `post-login` Action.
  </Card>

  <Card title="How to Configure User Profile Attribute Synchronization from Upstream Identity Providers" icon="person-chalkboard" href="/docs/manage-users/user-accounts/user-profiles/configure-connection-sync-with-auth0" horizontal>
    Enable synchronization to update user profile attributes from your external IdP each time users log in or disable synchronization to be able to edit user profile attributes directly.
  </Card>

  <Card title="How to Modify User Profile Attributes from Custom Database Connections" icon="person-chalkboard" href="/docs/manage-users/user-accounts/user-profiles/update-user-profiles-using-your-database" horizontal>
    Learn how to update user profiles when using your own user store as an identity provider.
  </Card>
</Columns>

### View and Search Users

<Columns cols={2}>
  <Card title="Identify Users" icon="person-chalkboard" href="/docs/manage-users/user-accounts/identify-users" horizontal>
    Learn how to uniquely identify users.
  </Card>

  <Card title="View User Details" icon="person-chalkboard" href="/docs/manage-users/user-accounts/view-user-details" horizontal>
    How to view users and their profile details.
  </Card>

  <Card title="How to List and Search Users with Search Queries" icon="person-chalkboard" href="/docs/manage-users/user-search/list-and-search-users" horizontal>
    Retrieve a list of all user profiles and filter results with Lucene search query strings.
  </Card>

  <Card title="How to Get Specific Users by Auth0 ID or Email" icon="person-chalkboard" href="/docs/manage-users/user-search/get-users-by-id-or-email" horizontal>
    Retrieve full user profiles for specific users with a matching email address or Auth0 user ID.
  </Card>
</Columns>

### Verify Emails

<Columns cols={2}>
  <Card title="Verify Emails using Auth0" icon="person-chalkboard" href="/docs/manage-users/user-accounts/verify-emails" horizontal>
    Overview of the different ways to verify user emails using Auth0
  </Card>

  <Card title="Resend Verification Emails" icon="person-chalkboard" href="/docs/manage-users/user-accounts/resend-verification-emails" horizontal>
    Describes how to resend verification emails to users via the Auth0 Management Dashboard and the Auth0 Management API.
  </Card>
</Columns>

### Link Accounts

<Columns cols={2}>
  <Card title="Link User Accounts" icon="person-chalkboard" href="/docs/manage-users/user-accounts/user-account-linking/link-user-accounts" horizontal>
    Understand how to link user accounts from various identity providers, so your users can authenticate from any account and be recognized by your app.
  </Card>

  <Card title="Unlink User Accounts" icon="person-chalkboard" href="/docs/manage-users/user-accounts/user-account-linking/unlink-user-accounts" horizontal>
    Learn how to use the Management API Unlink a User Account endpoint to unlink an identity from the target user account making it a separate user account again.
  </Card>
</Columns>

### Migrate Users

<Columns cols={2}>
  <Card title="Enable Automatic Migration to Auth0 from an External User Store" icon="person-chalkboard" href="/docs/manage-users/user-migration/configure-automatic-migration-from-your-database" horizontal>
    Gradually migrate users from your external user store to Auth0 as they log in by enabling import mode on your custom database connection.
  </Card>

  <Card title="Bulk Import User Data into Auth0 Database Connections" icon="person-chalkboard" href="/docs/manage-users/user-migration/bulk-user-imports" horizontal>
    Migrate users from an existing database or service to Auth0 using bulk imports for database connections.
  </Card>

  <Card title="Bulk Export User Data" icon="person-chalkboard" href="/docs/manage-users/user-migration/bulk-user-exports" horizontal>
    Export supported user profile data from Auth0 into a JSON-compatible or CSV format file.
  </Card>

  <Card title="Export Password Hashes and MFA Secrets" icon="person-chalkboard" href="/docs/manage-users/user-migration/export-password-hashes-and-mfa-secrets" horizontal>
    Request a PGP-encrypted export of password hashes and MFA secrets from your Auth0 tenant through a support case.
  </Card>
</Columns>

### Control Access

<Columns cols={2}>
  <Card title="Manage User Access to Applications" icon="person-chalkboard" href="/docs/manage-users/user-accounts/manage-user-access-to-applications" horizontal>
    Explains the basics of a user profile, how to create a user and view users and their profile details.
  </Card>

  <Card title="Deny User Access to an API with Rules" icon="person-chalkboard" href="/docs/manage-users/user-accounts/deny-api-access" horizontal>
    Learn how to use Auth0's Authorization Extension to deny users access to an API using rules.
  </Card>

  <Card title="How to Block and Unblock Users as a Tenant Administrator" icon="person-chalkboard" href="/docs/manage-users/user-accounts/block-and-unblock-users" horizontal>
    Control a user's ability to log in to your application by adding or removing tenant administrator blocks.
  </Card>
</Columns>

## Reference

<Columns cols={2}>
  <Card title="Auth0 User Profile Attribute Schema" icon="book-bookmark" href="/docs/manage-users/user-accounts/user-profiles/user-profile-structure" horizontal>
    View a reference for Auth0 user profile attributes, including validation requirements and support for features like search and upsert.
  </Card>

  <Card title="User Data JSON Schema for Bulk User Imports" icon="book-bookmark" href="/docs/manage-users/user-migration/bulk-user-import-schema" horizontal>
    View the JSON schema and property descriptions for user data used for bulk imports.
  </Card>

  <Card title="Lucene Query Syntax and Examples for Auth0 User Search" icon="book-bookmark" href="/docs/manage-users/user-search/user-search-query-syntax" horizontal>
    View Lucene query syntax details and examples for Auth0 user search version 3.
  </Card>

  <Card title="Limits and Best Practices for User Search" icon="book-bookmark" href="/docs/manage-users/user-search/user-search-best-practices" horizontal>
    Review limits and performance recommendations for user search, and alternatives to the Management API's List or Search Users endpoint by use case.
  </Card>

  <Card title="Metadata Limits and Best Practices" icon="book-bookmark" href="/docs/manage-users/user-accounts/metadata/metadata-fields-data" horizontal>
    View metadata field name requirements and supported data types as well as other related limits and best practices.
  </Card>

  <Card title="My Account API" icon="book-bookmark" href="/docs/manage-users/my-account-api" horizontal>
    Learn how you can empower your users to manage their own account information with the My Account API.
  </Card>
</Columns>

## Use Cases

<Columns cols={2}>
  <Card title="How to Change User Pictures with User Metadata" icon="wrench" href="/docs/manage-users/user-accounts/change-user-picture" horizontal>
    Define user metadata to change a user's picture field or change the default picture for all users.
  </Card>

  <Card title="Understand How Progressive Profiling Works" icon="wrench" href="/docs/manage-users/user-accounts/user-profiles/progressive-profiling" horizontal>
    Understand how progressive profiling can gather information about users over time as they engage with your website or application.
  </Card>

  <Card title="Get User Information on Unbounce Landing Pages" icon="wrench" href="/docs/manage-users/user-accounts/get-user-information-on-unbounce-landing-pages" horizontal>
    How to get user information with one-click social authentication on Unbounce landing pages.
  </Card>

  <Card title="User-Initiated Account Linking: Client-Side Implementation" icon="wrench" href="/docs/manage-users/user-accounts/user-account-linking/user-initiated-account-linking-client-side-implementation" horizontal>
    Learn how to provide a client-side UI that allows users to authenticate to their other accounts and link these to their primary account using a SPA.
  </Card>

  <Card title="User Account Linking: Server-Side Implementation" icon="wrench" href="/docs/manage-users/user-accounts/user-account-linking/suggested-account-linking-server-side-implementation" horizontal>
    Describes how to link user accounts with a regular web app using server-side code using a sample scenario.
  </Card>
</Columns>