sodcalculator

10 Tech How-To

MacOS: How to Change Admin Account Name

Guide 10-29303 · Updated · Step by step

To change the admin account name on macOS, you need to rename both the display name (what appears in the menu bar and login screen) and the home folder (the short name that determines the file path). The process is straightforward but requires care because the home folder is tied to system permissions and file paths.

Understanding Account Names on macOS

Every macOS user account has two names: the full name (also called the display name) and the account name (also called the short name or user name). The full name is what you see in the login window and in System Settings. The account name is the lowercase, no-spaces identifier used for the home folder path (/Users/yourshortname) and for terminal commands. For example, if your full name is “Alex Johnson” and your account name is “alexj”, your home folder is /Users/alexj.

When you change the account name, you must change both the short name and the home folder name so that all references stay consistent. If you only change the display name, the home folder path remains the same, which is fine for most users. However, if you want to change the short name (the one used in file paths), you must also rename the home folder.

Before You Start: Backup and Preparation

Changing the account name is safe if done correctly, but a mistake can break file permissions or make some apps unable to find their data. Before proceeding, do the following:

  • Back up your Mac using Time Machine or another backup method. This ensures you can restore if something goes wrong.
  • Log out of all other user accounts and make sure you are logged in as the admin account you are renaming.
  • Close all applications that might be using files in your home folder (e.g., email clients, browsers, development tools).
  • Note your current account name and full name so you can revert if needed.

If you are changing the short name, you will also need to update the home folder name. This is the most delicate step, as many system caches and app preferences reference the old path.

How to Change the Display Name (Full Name)

Changing the display name is the simplest part and does not affect file paths. Here’s how:

  1. Open System Settings (Apple menu > System Settings).
  2. Click on Users & Groups in the sidebar.
  3. Click the info button (i) next to your account, or right-click and select Advanced Options.
  4. In the Full Name field, enter your new display name.
  5. Click OK and then close System Settings.

Your full name will update immediately in the login screen and menu bar. No reboot is required.

How to Change the Account Name (Short Name) and Home Folder

Changing the short name is more involved because the home folder path must be renamed to match. Follow these steps exactly:

  1. Log in as the admin account you want to rename. Make sure you are not logged in as any other user.
  2. Open System Settings > Users & Groups.
  3. Click the info button (i) next to your account.
  4. In the Account Name field, enter the new short name (e.g., change “alexj” to “alexjohnson”). Do not use spaces or special characters.
  5. Click OK. macOS will warn that the home folder will be renamed automatically. Confirm.
  6. Log out and log back in. The system will rename the home folder from /Users/alexj to /Users/alexjohnson and update file permissions.

After logging back in, verify that your files are intact and that everything works. Some apps may need to be reconfigured if they stored absolute paths.

What to Do If the Home Folder Doesn’t Rename Automatically

Occasionally, macOS may not rename the home folder automatically, especially if you are using an older version or if there are permission issues. If the folder name remains the old one, you can rename it manually:

  1. Log in as a different admin account (or create a temporary admin account).
  2. Open Finder and go to /Users.
  3. Rename the home folder to the new short name (e.g., from alexj to alexjohnson).
  4. Open System Settings > Users & Groups, click the info button for your account, and change the Account Name to match.
  5. Log out and log back in.

If you see permission errors, use Get Info on the folder and enable read/write for your account, or use the chown command in Terminal (requires admin).

Common Problems and How to Avoid Them

Many users encounter issues after renaming because certain files still reference the old path. Here are the most common problems and solutions:

  • Apps that won’t open or lose data: Some apps store absolute paths in preferences. Re-login or restart the app. If the issue persists, reinstall the app.
  • Terminal prompts showing the old name: The shell prompt uses the short name. Log out and back in, or restart the terminal.
  • File permission errors: Run sudo chown -R yournewname:staff /Users/yournewname in Terminal to reset ownership.
  • iCloud or iMessage issues: Sign out of iCloud and sign back in to refresh the account association.
  • Login screen shows old name: This can happen if the display name wasn’t changed. Go back to Users & Groups and update the Full Name.

If you ever feel stuck, you can revert by changing the names back to the original values.

Frequently Asked Questions

Do I need to change the home folder name if I only change the display name?

No. The display name is purely cosmetic. The home folder path is based on the account name (short name). If you only change the full name, your files stay in the same place and nothing else needs to change.

Will changing the account name break my apps?

Most apps handle the change gracefully, but some that store absolute paths (like development tools or database apps) may need to be reconfigured. Always back up before proceeding, and re-login after the change to let the system update caches.

Can I change the admin account name without logging out?

No, you must log out and back in for the home folder rename to take effect. The system cannot rename a folder that is in use by the current session.

What if I have multiple admin accounts?

You can rename any admin account, but you must be logged in as that account or use another admin account to change it. If you are logged in as a different admin, you can still change the other account’s name, but the home folder rename will occur when that account next logs in.

Is there a way to change the account name using Terminal?

Yes, you can use the dscl command to change the short name, but it is more error-prone and requires manual home folder renaming. The graphical method is recommended for most users.

Will my files be deleted when I rename the home folder?

No, renaming does not delete files. The system simply changes the folder name and updates permissions. However, if you manually rename the folder while logged in as that user, you may see permission issues until you log out and back in.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →