QCFUM CSV Required and Optional Columns
QCFUM 2.0.4 uses a header-based CSV format. Every import needs name and email; the supported optional columns are username, method, profile, and invite_pack.
Password data does not belong in a QCFUM CSV. The parser rejects password-style headers before it creates any Joomla user or Invite Link.
Supported Columns
| Column | Required? | Current behavior |
|---|---|---|
name | Yes | Display name for the person. A blank value makes the row invalid. |
email | Yes | Must be a valid email address. It is also checked for an existing Joomla account. |
username | No | Used for Direct Create when supplied; blank lets QCFUM derive a username. |
method | No | Accepts direct or invite. Blank uses the selected Default Method. |
profile | No | Direct Create target. A friendly Profile title is recommended. |
invite_pack | No | Invite target. A friendly Invite Pack title is recommended. |
Header Normalization
Headers are trimmed, lowercased, and normalized to underscores. QCFUM also recognizes several friendly aliases, including full_name/display_name for name, email_address for email, user_name for username, profile_title/user_type_profile for profile, pack/invite_pack_title for invite_pack, and creation_method/import_method for method.
Unknown columns are ignored rather than imported into Joomla user data.
Password Columns Are Rejected
If a normalized header is password, pass, temporary_password, temp_password, or new_password, QCFUM rejects the CSV. Direct Create generates a private temporary password inside QCFUM; Invite Link recipients choose their own password during setup.
Row Validation
- Name cannot be blank.
- Email must be present and valid.
- A nonblank method must be exactly
directorinvite. - The effective method must be enabled by the administrator.
- Duplicate Joomla identity, Profile/Pack availability, tier, ACL, and quota checks still apply later in Preview/commit.
Use the Generated Sample
Download the current sample from the unified Import tab and keep its six canonical headers when possible. Friendly aliases are accepted, but canonical headers make troubleshooting and support easier.
Community Discussion
Want to compare Joomla user-onboarding 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.