====== Bulk User Import ======

===== Overview =====

The Bulk User Import tool allows administrators to create multiple user accounts at once from a CSV file. Each imported user receives a welcome email with a temporary password.

===== CSV Format =====

Prepare a CSV file with the following columns (header row required):

^ Column ^ Required ^ Description ^
| ''email'' | Yes | User's email address (must be unique) |
| ''first_name'' | Yes | First name |
| ''last_name'' | Yes | Last name |
| ''level'' | No | Security level: 1, 2, or 3 (default: 1) |
| ''role'' | No | Role label for association membership (e.g. "Learner") |

Example:
<code>
email,first_name,last_name,level,role
jane.smith@example.com,Jane,Smith,1,Learner
john.doe@example.com,John,Doe,2,Educator
</code>

===== Running the Import =====

  - Navigate to **Admin → Bulk User Import**
  - Upload your CSV file
  - Review the **preview table** — LEAST validates each row and highlights any errors before import
  - Common validation failures: duplicate email, invalid level, missing required field
  - Click **Confirm Import** to create the accounts
  - All imported users receive a welcome email with a temporary password

===== Import Log =====

Every import is logged in the **User Import Log**:
  - Date and time of import
  - Admin who ran the import
  - Number of accounts created / skipped
  - Per-row detail for any failures

===== After Import =====

  - Imported users can log in immediately after setting their password via the welcome email
  - To add users to an association, use [[admin:associations|Associations → Members → Add Directly]] (they are not automatically added to any association)
  - Password resets can be triggered from the user profile if the welcome email was missed