Troubleshooting the Username Not Found Message

Troubleshooting the Username Not Found Message requires identifying whether the problem is in plugin visibility, target eligibility, the short-lived handoff, or the separate frontend session before changing configuration.

Diagnostic procedure

  1. Open Users → Manage in Joomla.
  2. Copy the account’s exact Username value—not its display name or email address.
  3. Retry QCUI with that exact username.
  4. If the user was recently created/renamed, reload the Users list and make sure you are working on the same Joomla site/database.

Keep the layers separate

This failure occurs before target validation can proceed: Joomla did not resolve the submitted exact username. Confirm the account identity first; token issuance/session switching are not involved yet.

Information to preserve

Record the exact submitted username and the username shown in Joomla Users → Manage. Do not include the password; the relevant fact is whether Joomla can resolve that username on this site.

When to escalate

If Troubleshooting the Username Not Found Message persists after the documented layer is verified, stop creating repeated handoffs and preserve the exact error/context. A private support case should include version/state evidence but never passwords, session cookies, MFA secrets, or raw QCUI tokens.


Community Discussion

Want to compare support workflows, share practical tips, or discuss how you use this QCUI feature? Visit the QC User Impersonation Community. For private support, bug reports, account-specific issues, or feature requests, use the QuantaCade support system.