Jellyfin Module Username Generation Bug

Jellyfin WHMCS module

Which PUQ WHMCS module are you using?
Jellyfin WHMCS Module


Description of the Issue / Question

Username format not being followed


Steps to Reproduce (if it’s a problem)

  1. Set username prefix to j1-

  2. Set username format to Username generated by custom format

  3. Set custom username to {user_id}{service_id}


What You Expected to Happen

I expect a user to be provisioned with format like j1-271-1795


What Actually Happened

Random username is generated, like hjfnskxt


Environment Details

  • WHMCS version: 8.13.1
  • PHP version: 7.4
  • Web server (Apache / Nginx): Apache
  • Module version: PUQ_WHMCS-Jellyfin-latest.zip 08-Oct-2025 10:27
  • Hosting environment (shared / VPS / dedicated): Shared

Additional Information

Dear customer!
Thanks for the detailed report and configuration details.
We’re already looking into this issue and investigating why the configured username format (prefix + custom format) isn’t being applied and a random username is generated instead. We’ll get back to you as soon as we have an update or a solution.

The behaviour you are observing is not a bug in the Jellyfin WHMCS module but expected system behaviour. Username generation in this case is being controlled by WHMCS global ordering settings, which override the module’s custom username rules.

To allow the module’s custom username format (prefix + custom pattern) to be applied, please disable the Enable Random Usernames option in WHMCS. You can find it here:

Configuration → System Settings → General Settings → Ordering tab → Enable Random Usernames

This option in WHMCS is described as:

“Check to generate random usernames for services rather than use the first 8 letters of the domain.”

When this option is enabled, WHMCS forces random usernames to be generated and ignores any username format configured in our module. Once it is disabled, the module will correctly apply your custom username format (for example: j1-271-1795).

If you disable this option and still experience issues, please let us know and we will be happy to review further.

Best regards, Julia