Troubleshoot QCFUM CSV Import

QCFUM CSV Import is a Pro+ workflow with several independent gates: frontend CSV permission, current tier, administrator enablement, file/header limits, row validation, allowed Direct/Invite modes, and usable Profile/Invite Pack targets.

Use Preview as the diagnostic surface when preview is required. It tells you which rows are ready, skipped, duplicate, or invalid before accounts or Invite Links are committed.

Check the Feature and Administrator Gates

The manager needs qcfum.frontend.csv, Pro/Max/All Access, and CSV Import enabled by the administrator. The configured maximum is 1–5000 data rows; the default is 250. QCFUM also enforces a hard 2 MB limit for uploaded CSV data and preview payloads.

Validate the Header First

The header must include name and email. Supported optional fields are username, method, profile, and invite_pack, including documented normalized aliases. Password-style headers such as password, pass, temporary_password, temp_password, or new_password are rejected for the entire import.

Check Each Row

Rows with missing/invalid identity data are skipped. Existing Joomla email/username duplicates are skipped. A row can also be skipped if it requests Direct mode while Direct CSV creation is disabled, or Invite mode while CSV Invite Links are disabled.

Verify Defaults and Named Targets

Confirm the selected default User Type Profile and Invite Pack are currently available. In 2.0.4, an unrecognized Profile or Pack name in a CSV row can resolve back to the selected default rather than automatically invalidating the row, so review Preview’s resolved target carefully before committing.

Know the Current Preview and Duplicate Nuances

If “Require preview before import” is off, the frontend submission can process immediately even though the button label says Preview Import. Also, the stored Flag/Skip duplicate preference does not change the current server-side behavior: detected duplicates are skipped. Use the actual results summary—Created, Invite Links, Skipped, Failed—as the final record of what occurred.

Community Discussion

Want to compare Joomla user-management workflows, share practical QCFUM tips, or discuss how other administrators use this feature? Visit the QC Frontend User Manager Community. For private support, bug reports, account-specific entitlement problems, or feature requests, use the QuantaCade support system.