Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 20 additions & 8 deletions main/config/navigation/manage-users.json
Original file line number Diff line number Diff line change
Expand Up @@ -71,15 +71,27 @@
},
{
"group": "User Migration",
"root": "docs/manage-users/user-migration",
"directory": "accordion",
"pages": [
"docs/manage-users/user-migration",
"docs/manage-users/user-migration/configure-automatic-migration-from-your-database",
"docs/manage-users/user-migration/bulk-user-imports",
"docs/manage-users/user-migration/bulk-user-import-schema",
"docs/manage-users/user-migration/bulk-user-exports",
"docs/manage-users/user-migration/export-password-hashes-and-mfa-secrets",
"docs/manage-users/user-migration/user-migration-scenarios",
"docs/manage-users/user-migration/bulk-user-import-export"
{
"group": "Import User Data",
"expanded": true,
"pages": [
"docs/manage-users/user-migration/configure-automatic-migration-from-your-database",
"docs/manage-users/user-migration/bulk-user-imports",
"docs/manage-users/user-migration/bulk-user-import-schema",
"docs/manage-users/user-migration/user-migration-scenarios"
]
},
{
"group": "Export User Data",
"expanded": true,
"pages": [
"docs/manage-users/user-migration/bulk-user-exports",
"docs/manage-users/user-migration/export-password-hashes-and-mfa-secrets"
]
}
]
},
{
Expand Down
10 changes: 7 additions & 3 deletions main/config/redirects.json
Original file line number Diff line number Diff line change
Expand Up @@ -8557,11 +8557,11 @@
},
{
"source": "/docs/extensions/user-import-export-extension",
"destination": "/docs/customize/extensions/user-import-export-extension"
"destination": "/docs/manage-users/user-migration"
},
{
"source": "/docs/extensions/user-import-export",
"destination": "/docs/customize/extensions/user-import-export-extension"
"destination": "/docs/manage-users/user-migration"
},
{
"source": "/docs/customize/extensions/auth0-authentication-api-webhooks",
Expand Down Expand Up @@ -22669,7 +22669,11 @@
},
{
"source": "/docs/manage-users/user-migration/user-import-export-extension",
"destination": "/docs/manage-users/user-migration/bulk-user-import-export"
"destination": "/docs/manage-users/user-migration"
},
{
"source": "/docs/manage-users/user-migration/bulk-user-import-export",
"destination": "/docs/manage-users/user-migration"
},
{
"source": "/docs/get-started/universal-components/auth0-component-provider",
Expand Down
54 changes: 2 additions & 52 deletions main/docs/manage-users/user-migration.mdx
Original file line number Diff line number Diff line change
@@ -1,54 +1,4 @@
---
description: Overview of importing users from external applications into Auth0.
title: Import and Export Users
title: Import and Export User Data
description: Migrate your user data into and out of Auth0 with automatic migration and bulk imports and exports.
---
<Warning>

The **User Import/Export Extension** will be deprecated in September 2025. You can access the same features now available [directly in the Auth0 Management Dashboard](/docs/manage-users/user-migration/bulk-user-import-export).

</Warning>

Auth0 supports importing users from external applications using custom database connections, the Auth0 <Tooltip tip="Management API: A product to allow customers to perform administrative tasks." cta="View Glossary" href="/docs/glossary?term=Management+API">Management API</Tooltip>, or the User Import/Export Extension.

## Automatic migrations

Auth0 supports automatic migration of users from a [custom database connection](/docs/authenticate/database-connections/custom-db) to Auth0. This practice is sometimes known as **trickle migration** or **lazy migration**. By activating this feature, your users are:

* Moved to Auth0 the first time they log in after you set up the integration.
* Not asked to reset their password as a result of the migration.

<Card title="Availability varies by Auth0 plan">

Both your specific login implementation and your Auth0 plan or custom agreement affect whether this feature is available. To learn more, read [Pricing](https://auth0.com/pricing).

</Card>

When a user authenticates via a custom database connection marked for import to Auth0, the following process takes place:

* Auth0 authenticates migrated users against the Auth0 database.
* If the user has not been migrated, Auth0 executes your custom login script and, upon successfully log in, adds the user to the Auth0 database.
* Subsequent logins result in the user's credentials retrieved from Auth0, **NOT** your custom database.
* New users are automatically added to the Auth0 database.

<Frame>![User Migration Diagram](/docs/images/cdy7uua7fh8z/JAHBs6NzVRf0N5iXI7Wby/d0bfa23a1485aeb5d64bd52fe977d4fe/import-export-diagram.png)</Frame>

## Bulk user imports with the Management API

If you already have a user database, you can use our [`/post_users_imports`](https://auth0.com/docs/api/management/v2#!/Jobs/post_users_imports) Management API endpoint to populate a database connection with this information.

## Migrate users with the User Import/Export feature

The User Import/Export feature allows you to:

* Bulk import your existing database users into Auth0.
* Search for and export some (or all) of your Auth0 database users.

To use bulk import, you must be Dashboard Editor - Users or an Admin. To use bulk export, you must be Dashboard Viewer - Users, Editor - Users, or an Admin.

You can import and export user data using the [User Import/Export feature](/docs/manage-users/user-migration/bulk-user-import-export) available on the dashboard.

## Learn more

* [Configure Automatic Migration from Your Database](/docs/manage-users/user-migration/configure-automatic-migration-from-your-database)
* [Bulk User Imports](/docs/manage-users/user-migration/bulk-user-imports)
* [User Import / Export Extension](/docs/manage-users/user-migration/user-import-export-extension)
Loading
Loading