Bulk Operations

Overview

Bulk operations for Authentication allow you to import many users at once from a file, saving time when seeding test environments or migrating users from external systems.

Bulk User Import

Import multiple users from a CSV or JSON file:

1. Click the + menu and select Bulk Import….
2. Click Choose File and select your import file.
3. Review the preview table showing parsed user data.
4. Click Import Users to create all accounts.

CSV Format

The CSV file should have columns for user properties:

email,password,displayName
[email protected],password123,Alice Smith
[email protected],secret456,Bob Jones
[email protected],pass789,Carol White

• The email column is required
• password is optional (if omitted, users must use a password reset flow)
• displayName is optional
• A header row is expected but Stackpane can detect files without one

JSON Format

The JSON file should be an array of user objects:

[
  { "email": "[email protected]", "password": "password123", "displayName": "Alice Smith" },
  { "email": "[email protected]", "password": "secret456", "displayName": "Bob Jones" }
]

Import Preview

Before importing, Stackpane displays a preview table showing:

• Each row from the file with its parsed fields
• Validation warnings (e.g., missing email, password too short)
• The total number of users to be created

Review the preview carefully before proceeding.

Batching

Stackpane creates users in batches of 100 to avoid API rate limits. A progress indicator shows:

• The current batch number
• The number of users created so far
• Any errors encountered during creation

If an individual user creation fails (e.g., email already exists), Stackpane logs the error and continues with the remaining users.

Tips

• Test your import file with a small batch first to verify the format
• Use a local development environment for large test imports to avoid consuming production quotas
• After importing, use the search and filter features to verify the imported users