Skip navigation

How to change your WordPress username

Sick of using the name 'admin' to login to your WP installation? Have a user with the login 'PiNkbUnNiEz!1" but want to change it without that user losing all their posts/creating a new account etc.? Tried to do it but found the field disabled in your WP admin panel?
Here is what you need to do.

  1. Before you do anything, backup your database. If you don't know how to do this, ask at the WP forums or Google it - there are some plugins that will do this for you if you don't have access to things like phpMyAdmin (a MySQL tool which can be used to backup your database - Jem has a tutorial on this which may be useful)

  2. Paste this into a file. Name it anything you like, as long as it has a .php extension:

    $existing_username = 'admin';
    $new_username = 'MY_NEW_USERNAME';

    // —————

    if (!file_exists('wp-config.php')) exit('Could not find wp-config.php, please make sure you place this file in the same directory as all your WP files.');

    require 'wp-config.php';

    $link = @mysqli_connect(DB_HOST, DB_USER, DB_PASSWORD);
    if (!$link) exit('Could not connect to MySQL');
    mysqli_select_db($link, DB_NAME) or exit('Could not connect to MySQL');

    if (mysqli_query($link, 'UPDATE `' . $table_prefix . "users` SET `user_login` = '" . mysqli_real_escape_string($link, $new_username) . "' WHERE `user_login` = '" . mysqli_real_escape_string($link, $existing_username) . "' LIMIT 1")) echo 'Username updated, your username is now ' . $new_username . '.';
    else echo 'Could not update your username. MySQL said: ' . mysqli_error($link);


    Change the first two lines (excluding the one that says '<?php', obviously :P ) to your existing username (probably admin) and your new desired username. Save the file, then upload it to your WordPress directory. Make sure this file is in the same place as wp-config.php.

  3. Go to the file in your browser, e.g. yoursite/wordpress/the-file.php and voilà! :D

Please note: this post is now over 1 decade old.

Older posts are archived for historical reasons and also for those who may find their contents useful. Facts, links or opinions within this article are likely to have changed; the article itself may also no longer represent my own views on the subject. Please bear this in mind when reading these posts.

Comments (10)

  1. Very interesting, where did you find this, or did you write the code your self?
    Thanks, Peter

    Peter Green's Gravatar Peter Green on

  2. Woot! Gotta remember this for whenever I'm too lazy to click into phpMyAdmin and want to change a username. :D

    Melissa's Gravatar Melissa on

  3. @Peter: I wrote it myself :)

    Amelie's Gravatar Amelie on

  4. I'm more tempted to change people's passwords to "PiNkbUnNiEz!1" instead... :P

    Vickie's Gravatar Vickie on

  5. This is an interesting of changing the admin name! I'm not too great with PHP though. I've always used phpmyadmin to change my admin name. Hahaha. Thanks for sharing. :)

    Ivy's Gravatar Ivy on

  6. *bookmarks*
    Handy! :)

    Holly's Gravatar Holly on

  7. Can you not just go into phpMyAdmin and change it? *have never tried though*

    Rilla's Gravatar Rilla on

  8. ^ Yes you can, but it requires access to PMA and knowledge of where to find everything.

    Just thought this would make it a bit easier. *Shrug*

    Amelie's Gravatar Amelie on

  9. Interesting tutorial. I ought to bookmark this, could come in handy when someone actually tries to sing up as "PinkBunnieZ1!!!".

    Morgan's Gravatar Morgan on

  10. OMG! You're descended from Jonathan Swift =OOOO SWEET~

    Baby bacon all the way! =D

    Cindy's Gravatar Cindy on

Previous entry: Akismet for Guestblock | Next entry: You don't need to ConvertToPHP just to use includes