How to Change Your Home Folder’s Name on macOS

If you buy a used Mac, or inherit one from a family member, chances are you’ll want to change the name of the home folder. It’s completely possible, and you don’t even need to use Terminal. However, you can run into some funky problems, so don’t jump into this without consideration.

Before you do any of this, make a backup. While this process should be painless, “should” is no guarantee. It’s also highly recommended that you turn off iCloud Documents and Desktop if you have that feature enabled. iCloud doesn’t always cope well with home folder changes.

First, you’ll need to create an additional administrator user on your computer. If you already have one, you can skip this part.

1. Open the “Users & Groups” pane under System Preferences.


2. Click the lock in the lower-left to unlock the Preference pane. Enter your password when prompted.


3. Click the plus button under the list of existing users.


4. In the resulting dialog box, click the drop-down that says “Standard” and change it to “Administrator.”


5. Enter a name for the user account. You can delete this account as soon as you’re done with it, so no need to get fancy.

6. Click the Create User button when you’re done.

Now you’ll need to switch from the account with the home folder you want to change to your new (or existing) admin account.

1. Log out of the current user’s account under the Apple menu.


2. Log into your admin user. If this is the first time you’ve logged into the account, you’ll be prompted to sign into iCloud just as you were when you booted up your Mac for the first time. Don’t do this.


3. Open Finder and navigate to the home folder you want to modify. You’ll find it at “/Users/[user name].”


4. Rename the folder as you would any other directory. Enter your administrator account password when prompted.


5. Open the “Users & Groups” preference pane again.


6. Right-click on the name of your main account in the sidebar and choose “Advanced Options.”


7. In the resulting pane you’ll need to change two things: the account name and the home directory. Optionally, you can also change the full name (I did), but it’s not strictly necessary. Type your new user name into the account name and full name fields, and click the “Choose…” button to select your renamed home folder.


9. Click OK and quit System Preferences.

10. Log out of your admin account and back in to your main account.

11. Optionally, delete the admin user you created. Select the admin account in the Users & Groups pane and click the minus icon under the list of users. Make sure to select “Delete the home folder” when you do. Then, click Delete User.


There’s a reason that changing the name of your home folder isn’t done regularly: It usually breaks something. In testing, this process, which is the process recommended by Apple, nuked almost all of my OS preferences. Dock settings, login items, keyboard shortcuts, iCloud – all of it was toasted. I had to manually reset everything.

Things outside the OS can break too. Some programs on your computer specify the location of resources by using the full file path. Most of the time reinstalling the program will fix this issue. That’s what I had to do with my Adobe software.

Dropbox is a great example of a program that requires a little more cajoling. If the name of your home folder changes, Dropbox will complain when launched.


The dialog box makes it sound like a permissions problem, and Dropbox will request your username and password to fix it. However, that’s not actually the issue. The real problem is that the folder Dropbox is looking for no longer exists.


Here’s the fix for this particular problem.

1. Download the most recent Dropbox installer.

2. Open Terminal. If you’re not familiar, you can find it under Applications/Utilities or by typing “Terminal” into Spotlight.

3. Type the following commands into Terminal. Enter them one at a time, and press Enter after each one. Copy and paste to avoid typos. You’ll have to enter your password after the first command, but each command afterwards will run without it.

sudo chown "$USER" "$HOME"
sudo chown -R "$USER" ~/Dropbox
sudo chmod -R u+rw ~/Dropbox
sudo mv ~/.dropbox ~/.Trash/dropbox.old
sudo mv ~/.dropbox-master ~/.Trash/dropbox-master.old
sudo chmod -N ~
sudo mv /Library/DropboxHelperTools ~/DropboxHelperTools.old

If you’re curious, these commands reset some permissions and trash some Dropbox setup files that refer to your old home directory.

4. Reinstall Dropbox from the .dmg you downloaded earlier.

While it’s easy to change the name of your home directory, don’t enter into it lightly. You might have to spend several hours fixing problems both small and large, so make sure the change really matters.

Leave a Reply

Yeah! You've decided to leave a comment. That's fantastic! Check out our comment policy here. Let's have a personal and meaningful conversation.