Handle Duplicate Users During CSV Import

QCFUM checks CSV rows against existing Joomla users before creating a Direct account or Invite Link. A duplicate match is skipped; QCFUM does not overwrite or merge the existing Joomla account.

The Administrator setting offers Flag duplicates in preview and skip on import or Skip duplicates automatically. In the current 2.0.4 processing code, both choices still protect against duplicate creation by skipping the row.

What Counts as a Duplicate

QCFUM normalizes the row email and checks both email and a supplied username through its Joomla user-existence helper. Preview reports the returned duplicate reason so staff can see which identity collided.

Current 2.0.4 Preview Behavior

Preview classifies an existing identity as Duplicate and states that the row will be skipped when committed. This duplicate assessment occurs regardless of the stored Flag/Skip preference.

Current 2.0.4 Commit Behavior

The importer checks for the duplicate again before either workflow runs. If a match exists, it increments Skipped, records a Duplicate message for the row, and does not call Direct Create or Invite Link creation.

What the Flag/Skip Setting Changes Today

The setting is saved and exposed in the Administrator UI, but the 2.0.4 Preview/processor does not branch on that value: duplicate rows are detected and skipped in either mode. Treat the setting as intent/configuration state rather than a reason to expect duplicate accounts to be imported.

Safe Duplicate Workflow

  1. Preview the CSV.
  2. Expand duplicate rows and compare the existing Joomla account with the source data.
  3. Remove or correct rows that were not intended to target an existing person.
  4. If the existing account needs changes, use the appropriate Joomla/QCFUM user-management workflow instead of CSV onboarding.
  5. Commit only after the duplicate list makes sense.

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.