User Import/Export

Overview#

The User Import/Export module provides bulk user management capabilities for efficient onboarding, data migration, and compliance operations. Import users from CSV or JSON files with automatic validation and duplicate detection, export user data for backup and analysis, and fulfill GDPR data portability requests, all through asynchronous job processing that handles large-scale operations reliably.

Key Features#

• Bulk User Import - Import users from CSV or JSON files with automatic validation, duplicate detection, and role mapping. Configure organization assignment, welcome email delivery, and password handling. Asynchronous processing with real-time progress tracking handles imports of any size with detailed error reporting and rollback capability.

• Migration Support - Direct migration paths from Auth0 and AWS Cognito with automatic field mapping. Import users from your existing identity provider and map roles, attributes, and metadata to the platform schema with minimal manual configuration.

• Flexible Export Options - Export user data in CSV format for spreadsheet analysis or JSON for complete data with metadata. Filter exports by organization, date range, active status, and role. Sensitive data controls ensure appropriate handling of personal information.

• GDPR Data Export - Generate individual user data packages for GDPR right-to-data-portability requests. Complete exports include profile information, activity logs, session history, and audit trail entries in an encrypted, machine-readable format.

• Asynchronous Job Processing - All import and export operations run as background jobs to prevent timeouts and enable progress tracking. Monitor job status in real time with progress indicators, completion estimates, and detailed error logs. Job history is retained for 90 days.

• Error Handling and Recovery - Detailed error reporting with row-level information for validation failures, duplicate detection, and format issues. Download error logs for review, correct source data, and retry failed imports. Rollback capability allows reversing completed imports within 24 hours.

Supported Formats#

Use Cases#

• User onboarding at scale by importing hundreds or thousands of users from CSV files with automatic validation, role assignment, and welcome email delivery.
• Identity provider migration from Auth0 or AWS Cognito with automated field mapping, preserving user attributes and organizational assignments.
• Compliance data requests using GDPR export to generate complete, encrypted user data packages that fulfill right-to-data-portability obligations within regulatory timelines.
• Regular data backup with scheduled exports that provide point-in-time user data snapshots for disaster recovery and compliance documentation.
• Organization restructuring by exporting current user data, modifying assignments offline, and re-importing updated records with appropriate role and department changes.

Getting Started#

1. Download Template - Get the CSV or JSON import template with field definitions and example records.
2. Prepare Data - Populate the template with user records, ensuring email addresses are valid and roles match available options.
3. Test Import - Import a small sample (10-20 users) to verify field mapping, role assignments, and login functionality.
4. Full Import - Upload the complete file and monitor the background job progress through the real-time dashboard.
5. Review Results - Check import statistics, download any error logs, and verify imported users can access the platform.

Availability#

• Enterprise Plan: Included (all import/export formats, migration support, GDPR export, unlimited batch size)
• Professional Plan: CSV import/export included; JSON format, migration support, and GDPR export available as add-on

Last Reviewed: 2026-02-05