User Import Export

What's new?

Version 1.4.3: 19 October 2026

• Runs on Joomla 5 and 6 with the Behaviour Backward Compatibility plugins disabled
• Templates and helpers use current Joomla APIs

Version 1.4.2: 3 October 2026

• Import: the "Send email" option is now respected. When it is unticked, imported users get no email at all. Before, Joomla's own "account created" email went to every new imported user, with an empty password line, whatever the option said.
• Import: when "Send email" is ticked, each new user gets one welcome email with the username and either the password the import generated or a link to set a password. It never contains an empty password.
• Import: rows with no username or email (empty, or the column is not mapped) are skipped with a clear error. No user is created or changed for those rows.
• Export: PHP notices and deprecation messages can no longer get into CSV, JSON or XML downloads and corrupt them (seen on PHP 8.4 with error reporting switched on).
• Updates: the update server address now points to updates.joomlax.com, so sites see new versions in System - Update - Extensions.
• The installer refuses Joomla 4 and PHP below 8.1 with a clear message (the version check in 1.4.0 never ran).
• Download Key support: enter your JoomlaX download key in System - Update Sites so updates install from Joomla's Update button.
• Imported and updated users are recorded in User Actions Log (as user added / user updated), when the site logs Users events.

Version 1.4.0: 11 May 2026

• Import: Joomla user plugins after save — After creating a user or updating core account data (including group assignment from the CSV), the extension dispatches onUserAfterSave, matching normal saves in Users. Third-party integrations (for example AcyMailing list subscription when “new Joomla user” rules are used) can run without opening each user in the backend.
• Import: group column handling — The groups field is no longer passed to the #__users table on insert/update; it is only applied via the user–group map, avoiding invalid SQL when the import file includes a group column.

Version 1.3.0: 05 April 2026

• Import: “Require Password Reset” option fixed — Unchecking this option on the import mapping screen is now honoured. Previously, browsers do not submit unchecked checkboxes, and the importer defaulted missing values to “require reset”, so every new user was still forced to reset their password on first login.
• Import: reliable boolean options — Added hidden fields and explicit parsing for the import “Require Password Reset” and “Send email” checkboxes so submitted values always match what you select on the form.

Version 1.2.0: 14 February 2026

• Skipped Rows Report - When an import has skipped or error rows, you can now view a detailed report.
  • Report button in the Logs view opens a modal listing all skipped rows (row number, email/username, reason) and error rows (row number, message).
  • Reasons include "User already exists (add-only mode)" and "User not found (update-only mode)".
• Downloadable Report (CSV) - Export the skipped and error report to CSV.
  • Download Report button in the Logs Actions column for import entries with skipped or errors.
  • Also available from inside the Report modal.
  • CSV includes Skipped Rows (Row, Email/Username, Reason) and Error Rows (Row, Message) sections.

Version 1.1.0: 13 February 2026

• Import of Custom Fields — You can now import Joomla Custom Fields (including radio buttons, list, text, etc.) when importing users.
  • Custom fields appear in the import field mapping dropdown under "Custom Fields".
  • Map your file columns to any user custom field (e.g. "Custom: Gender", "Custom: Preferred Contact").
  • Values are saved to the database for both new users and when updating existing users.
  • Supports all custom field types that store a single value (radio, list, text, etc.).
• Export of custom fields (including radio) was already supported in 1.0.0; this release adds the matching import capability.

Version 1.0.0: 01 January 2026

• Initial release.
• Export users to CSV, Excel (XLSX), JSON, XML, or SQL.
• Import users from CSV, Excel (XLSX/XLS), JSON, or XML.
• Field mapping with auto-detect and support for core fields, profile fields, and user groups.
• Export of custom fields (all types, including radio).
• Import modes: add only, update only, or add and update.
• Match existing users by email or username.
• Pre-import validation (emails, usernames, duplicates).
• Password handling options (exclude, hashed, placeholder on export; auto-generate, import hashed, require reset on import).
• Reusable export/import templates.
• Operation logging with optional file re-download.
• Dashboard, filters, and Joomla 5/6 compatibility.