trio.so
How-Tos

How to Change the User Name and Rename the Home Folder on Mac

Change the user name on a Mac and rename the home folder in Apple's order, what can break afterwards, and how to roll back. Works on current macOS.

Mountain landscape representing leadership perspective and vision
Written by
Atena Ladchartabi

Content writer, trio.so

Published on
Modified on

To change the user name on a Mac, rename the home folder first, then update the account name and home directory path in Users & Groups > Advanced Options, in that order. You do both from a second administrator account, because macOS will not rename an account you are logged in to. Back up first. A mistake can lock you out of the account.

Full name, account name and home folder: which one do you want?

A Mac account has three names, and most guides mix them up.

  • Full name. The name shown on the login screen and in the menu bar. It can contain spaces and capitals. Changing it is safe and needs no folder rename.
  • Account name (user name). The short name macOS uses for permissions and in Terminal, for example jsmith. Apple says not to use spaces in it.
  • Home folder. The folder at /Users/jsmith that holds the user's files. Its name should match the account name.

If you only want a different name on the login screen, change the full name and stop. The steps below are for when the short account name and the folder must change too, for example after a legal name change or when you hand a Mac to a new employee.

Before you start

  • Back up the Mac. Apple warns that doing this incorrectly could damage the account and stop you logging in with it.
  • Create or use a second administrator account. You can only rename an account while you are logged in to a different one.
  • Log out of the account you are renaming. Do not just switch users.
  • If the home folder is shared through file sharing, stop sharing it first.

These steps do not change the login password or the computer's network name. They apply to macOS Ventura 13 and later, where the path is System Settings > Users & Groups. Older versions use System Preferences with the same order.

How to rename the home folder on a Mac

  1. Log in to the other administrator account.
  2. In Finder, choose Go > Go to Folder, type /Users and press Return.
  3. Select the folder of the account you are renaming, press Return and type the new name. Use no spaces.
  4. Enter the administrator name and password when asked.

How to change the user name and home directory name on a Mac

Stay logged in to the administrator account.

  1. Open System Settings > Users & Groups.
  2. Control-click the account you are renaming and choose Advanced Options. Enter the administrator password.
  3. Change the User name field to match the new folder name.
  4. Change the Home directory field to the same name. Keep /Users/ at the start, for example /Users/jsmith.
  5. Optionally change the Full name. It does not have to match.
  6. Click OK, restart the Mac and log in to the renamed account.

Source: Apple's guide, Change the name of your macOS user account and home folder. Check the field names on your version before you click OK.

What can break after a rename

  • Apps that store the old path. Some apps keep /Users/oldname in their settings. Open each important app once and check its file locations.
  • Keychain prompts. If the login keychain will not open, see how to fix keychain issues on Mac.
  • Permissions. Files should keep working because they belong to the same account. If something is read only, the home folder name and the account's home directory field do not match.
  • Scripts and login items. Anything with a hard coded path needs editing.

How to roll back

Log in to the administrator account, rename the folder back, and set the user name and home directory fields back to the old values. If the account no longer logs in, restore from the backup you took first.

Renaming a user on a Mac you manage

Do not rename accounts with a script on a managed Mac without a backup and a second admin account in place. A script that renames the folder and changes the account record in two steps leaves the user locked out if it stops between them. For a name change on a managed fleet, do one Mac as a test, then use a ticket per device. If you also need to change the administrator account or the computer name, see how to change a MacBook administrator name and how to change a MacBook hostname.

Managing this across many devices

Renaming one Mac is a ten minute job. Across a fleet it is not, so check the account name and home folder before you enroll a Mac, not after. trio.so enrolls Macs through Apple MDM and lists each one with its details in one console. See Apple MDM.

Related reading: Mac administrator account, fix keychain issues on Mac and let standard users install programs on Mac.

Ready-to-use Templates

Must-have Template Toolkit for IT Admins

Explore All
Template Toolkit

Manage your Macs from one console, with remote commands and a terminal

Renaming a home folder by hand puts the user's data at risk. trio.so lets IT run commands on managed Macs from a console. Try it free for 14 days.

Start free trial

Manage Every Device From One Console

trio.so brings device management, patching and security policies for Windows, macOS, Linux, iOS/iPadOS and Android into one console. Enroll a device and see it in the console within minutes.

14-day free trial. No credit card required.

trio.so brings device management, patching and security policies for Windows, macOS, Linux, iOS/iPadOS and Android into one console. Enroll a device and see it in the console within minutes.

Smiling womanAbstract geometric patternAbstract geometric patternSmiling womanSmiling woman

Frequently Asked Questions (FAQ)

Have questions? We've got answers. This section covers some of the most commonly asked questions related to this topic.

Rename the home folder in /Users from another administrator account, then change the User name and Home directory fields in Users & Groups > Advanced Options and restart.

Yes. Rename it from a second administrator account, then update the account's Home directory field to the same name, or the account will not log in.

Apps and scripts that stored the old path, and sometimes the login keychain. Back up first and check your key apps after the first login.

Related

From the blog

The related industry news, interviews, technologies, and resources.