|
1 | 1 | --- |
2 | | -description: Overview of importing users from external applications into Auth0. |
3 | | -title: Import and Export Users |
| 2 | +title: Import and Export User Data |
| 3 | +description: Migrate your user data into and out of Auth0 with automatic migration and bulk imports and exports. |
4 | 4 | --- |
5 | | -<Warning> |
6 | | - |
7 | | -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). |
8 | | - |
9 | | -</Warning> |
10 | | - |
11 | | -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. |
12 | | - |
13 | | -## Automatic migrations |
14 | | - |
15 | | -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: |
16 | | - |
17 | | -* Moved to Auth0 the first time they log in after you set up the integration. |
18 | | -* Not asked to reset their password as a result of the migration. |
19 | | - |
20 | | -<Card title="Availability varies by Auth0 plan"> |
21 | | - |
22 | | -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). |
23 | | - |
24 | | -</Card> |
25 | | - |
26 | | -When a user authenticates via a custom database connection marked for import to Auth0, the following process takes place: |
27 | | - |
28 | | -* Auth0 authenticates migrated users against the Auth0 database. |
29 | | -* 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. |
30 | | -* Subsequent logins result in the user's credentials retrieved from Auth0, **NOT** your custom database. |
31 | | -* New users are automatically added to the Auth0 database. |
32 | | - |
33 | | -<Frame></Frame> |
34 | | - |
35 | | -## Bulk user imports with the Management API |
36 | | - |
37 | | -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. |
38 | | - |
39 | | -## Migrate users with the User Import/Export feature |
40 | | - |
41 | | -The User Import/Export feature allows you to: |
42 | | - |
43 | | -* Bulk import your existing database users into Auth0. |
44 | | -* Search for and export some (or all) of your Auth0 database users. |
45 | | - |
46 | | -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. |
47 | | - |
48 | | -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. |
49 | | - |
50 | | -## Learn more |
51 | | - |
52 | | -* [Configure Automatic Migration from Your Database](/docs/manage-users/user-migration/configure-automatic-migration-from-your-database) |
53 | | -* [Bulk User Imports](/docs/manage-users/user-migration/bulk-user-imports) |
54 | | -* [User Import / Export Extension](/docs/manage-users/user-migration/user-import-export-extension) |
0 commit comments