Username change

Username change 2.1.1

No permission to download
Compatible XF 2.x versions
  1. 2.0
  2. 2.1
Additional requirements
For latest version
• XenForo 2.1.1
• PHP 7 +
Visible branding


This addon brings configurable username change functionality to your forum, inluding permissions, managable username change history, "Latest username changes" widget, trophy criteria and with "User change log" support.

This is an open source addon. Visit GitHub repository for source code.

All my addons are free...

But if you want to
  • Be informed of all news about developing new addons
  • Suggest and vote for new addons
  • Try beta versions
  • Receive 24-hour early access to new addons
Then you can support me on my Patreon!


Username changes

If user can see username changes and meet privacy check, he will see a small triangle near username.

Clicking on it will show a box with X (configurable) latest username changes (5 by default):


The same works with user's info tooltips, when hovering over username or avatar:


Hovering over username change item will show change date:


Username changes list

If the user has more than 5 username changes, you will see a "View all" button, which leads to a page with all current user's username changes list:


Username change history management

Users with appropriate permissions can selectively remove username changes:


Moreover, there is an option to clean the whole username changes history:


Changing username

Users can change their usernames on "Account details" page:


After changing, the username field will be disabled. Next available username change time is showing right below the field:


You can set the number of days between username changes via permission:


"Ulimited" options allows users to change their usernames without any time restrictions:


User activity records

Username changes are displaying in "Latest activiy" tab.


Your followers, for example, can see your username changes in "Your news feed" tab.


You can use "New username changes" widget with two styles (full and simple) and configurable number of showing username changes.

Full style:


Simple style (for sidebars):


User change log

All username changes + history edits will appear in "User change log" in ACP:



You can use two new criteria when creating a trophy (or showing a forum notice):
  • User has changed their username at least X times
  • User has changed their username no more than X times
  • Change username (Yes/No)
  • Days between username changes (Unlimited/Number)
  • Delete own username change history (Yes/No)
  • View username changes (Yes/No)
  • Manage username change history privacy (Yes/No)
  • Delete any username change history (Yes/No) (moderator permission)
Default settings

Some options and funcionality will be set automatically after installing addon.

By default all registered users can see username changes and change their own username one time in 30 days.
Registered users can'not edit their username change history.

Moderators and admins can edit any user's username change history.

"Latest username changes" widget is showing on "What's new" page right under "Latest posts" widget.


  1. Download the addon
  2. Upload contents of upload folder to your forum root
  3. In admin control panel go to "Addons" section and install Username Changes
  1. Uninstall the addon from ACP
  2. Go to forum root folder and remove src/addons/CMTV/UsernameChange folder.
That's it!

All my addons are free...

But if you want to
  • Be informed of all news about developing new addons
  • Suggest and vote for new addons
  • Try beta versions
  • Receive 24-hour early access to new addons
Then you can support me on my Patreon!
First release
Last update
2.33 star(s) 3 ratings

More resources from CMTV

  • Math
    Math support and a handy button to insert it all rolled into one addon!
  • Code
    Unmaintained Code
    Improving [code] bbcode and code editor. A must have addon if you share code on your forum!
  • Question Threads to XF 2.2
    Question Threads to XF 2.2
    Convert "Question Threads" addon data to XenForo 2.2 internal question-solution system.
  • Badges
    Create fancy-looking badges and award users for valuable and unique actions!
  • Rules
    Easily create rules and group them into categories. Bring the power of law to your community!

Latest updates

  1. Patch 2.1.1

    This is a patch for XF 2.1.1 and above only! Fixes Fixes a bug where recent username change...
  2. Update 2.1.0 – XenForo 2.1 support & New features

    Username Change 2.1.0 was rewritten from scratch. It is compatible with previous addon version...

Latest reviews

DO NOT INSTALL ON VERSION 2.2.2, it will wreck your database! It's taking me hours to figure out all the damage its caused.
Addon doesn't work, fails to recognize usergroup hierarchy. Developer has not responded this or other plugin issues.
Fantastic add-on, one that is much needed (you'd think it would be core functionality by now). Keep up the good work my friend!