Move a project in Unity

How to move or copy a Unity project (without breaking it)

In Unity by John20 Comments

When working on a project in Unity, you may want to move it to another computer or a different folder location.

Maybe you’re looking for a simple way to back up your work, or maybe you just want to work on it from different computer than you started on.

Perhaps you want to duplicate the entire project in the same location so that you can work on two versions at once…

Whatever the reason, while it is a very simple task there are a couple of tips to keep in mind that will make moving or copying a Unity project much easier.

So… what’s the best way to move a Unity project to a new location?

The right way to move or duplicate a Unity project is by copying the entire folder to the new location, making sure to enable ‘Visible Meta Files’ in the Project Settings first. It also helps to remove the Library and Temp folders when moving the project, as these can be very large and are not required, as Unity will rebuild them automatically.

This is different to exporting a Unity Package, which does not include project-wide settings and package manager dependencies. Moving a project by copying the folder is the best method for moving an entire project to a new location without breaking it.

In this article I’ll be exploring each step in detail, as well as a few tips to make moving your project a little easier.

Here’s what you’ll find on this page:

How to move a Unity Project step by step

  1. Enable Visible Meta Files
  2. Delete the Library and Temp folders (optional)
  3. Compress the folder to a Zip file (optional)
  4. Copy the project folder to the new location
  5. Add the project to Unity Hub

Advertisement

1. Enable Visible Meta Files

Visible Meta Files Option in Unity

The Version Control option in Project Settings allows you to make hidden meta files visible. A must when using version control software.

Got to Edit > Project Settings and select the Editor Tab.

Find the Version Control Mode and set it to Visible Meta Files.

Why should you enable Visible Meta Files in Unity?

In Unity every asset has hidden meta data that is used to make and maintain references  between script variables, game objects and assets. This meta data is stored in .meta files which are created by Unity when you import assets.

These meta files are hidden by default and, while Unity does not need to be visible to use them, other software may do. Enabling Visible Meta Files simply makes sure that they are included when the project is moved or copied.

Unity Meta Files

Normally hidden, Unity’s meta files are used to maintain references between objects and assets.

This prevents the hidden references from being recreated, overwritten, or duplicated which can cause broken connections and errors. This is especially important if using version control software or when accessing the same project from multiple locations.

The good news is that, while researching for this article, I wasn’t able to deliberately break a project by keeping the meta files hidden, so it’s unlikely that missing out this step will cause you many problems in most scenarios.

However,

As it’s such an easy step, and because it can potentially protect your entire project from breaking when you move it, it’s good practice to set them to visible anyway.

Advertisement

2. Delete the Library and Temp folders from the project directory (optional)

Delete Library and Temp folders in Unity

Deleting the Library and Temp folders can help to bring the size of the project down before moving it.

This step is optional and only applies if you wish to move a Unity project to a different computer.

Open File Explorer (Windows) or Finder (Mac) to find your Unity Project.

Unless you’ve changed the default location for new projects, you’ll find your project in your Documents folder under Unity Projects.

If you can’t find your project folder then open up the Unity Hub, find your project in the list and select ‘Show in Explorer’.

Once you’ve found your project folder, copy the entire directory to a new location (your desktop for example).

Open the copy and delete the Library folder and the Temp folder (if there is one) from the directory.

Why should you delete the Library and Temp folders?

You don’t have to delete these folders.

The reason that you may want to, however, is to reduce the size of the directory before you move it.

For example, to test this method I moved a small project which, when zipped, was 180 MB in size with the Library folder included.

By removing the Library folder first, it was only 25MB.

Removing the Library and Temp folders can massively reduce the size of the folder temporarily. This is ideal if you want to fit it on a small USB stick or share it online.

Then, when you open the project copy, Unity will rebuild the Library folder in the new location, restoring it to its original size.

Why make a copy of project directory first?

How to copy a Unity project to your desktop.

Copying the project to a different folder first lets you remove the unnecessary Library and Temp folders without damaging your project.

It is safe to remove the Library and Temp folders from the original project directory as Unity will simply rebuild them when you next open the project.

However,

For the time it takes to make a copy of the project first, it’s much safer to do it this way. As deleting the wrong folder by mistake could break your project.

Advertisement

3. Compress the folder to a Zip file (optional)

How to Compress and move a Unity Project

Unity projects, even small ones, have thousands of files. Zipping the directory makes the project easier and quicker to move.

This step is optional. It’s most relevant if you wish to upload a Unity Project using cloud storage, such as Dropbox.

When you’re ready to move your project, it’s time to Zip the project folder.

Right Click on the root folder, which is named after your project, and select Send To > Compressed (Zipped) Folder (Windows) or Compress (Mac).

Why should you Zip the project folder first?

You don’t have to Zip the project folder to move it.

However…

A Unity project, even a small one, may include many thousands of files.

And while this may not cause you any issues when moving a project locally, it can affect performance when uploading and downloading so many individual files. Something you may have noticed if you’ve ever created a new project (even a completely empty one) inside of a Dropbox folder.

For example,

It took 1m 33s to upload my test project which, although small, included almost 10,000 individual files.

To upload the same project when zipped, only took 40 seconds.

And while the time savings in my example are small, it’s likely that your project is much larger and much more complex.

Zipping the folder makes it easier to manage and quicker to move.

Advertisement

4. Copy the project folder to the new location

Moving a Unity Project to a new folder (visualisation)

Move the copied project folder to the Unity Projects folder on the target computer.

Lastly, paste the directory, or extract the zipped project folder, to the new location.

How to create a duplicate Unity Project in the same location

If you’re not moving the project to a new location, and all you want to do is create a working duplicate in the same folder as the original project, here’s how to do it.

  1. Enable Visible Meta Files but ignore steps 2 and 3.
  2. Duplicate the project folder inside the Unity Projects directory.
  3. Rename the new folder as you like.
  4. Add the new project copy to Unity Hub (see below).

Advertisement

5. Add the project to Unity Hub

Add a new project to the Unity Hub

Click Add to add the new location to your Unity Hub after you’ve moved it.

If you’re using Unity Hub you’ll need to add your, now moved, project to the list of Projects in your dashboard.

Simply open Unity Hub, click Add and select the new project directory.

At this point you may also want to make sure that you have the same version of Unity installed as the source project (if moving the project to a new system).

If you don’t, you can download a specific version of Unity, (including older versions) from Unity’s download archive.

You can now open the project as normal.

How to remove a project from Unity Hub

If you’re no longer using the original project you may want to remove it from the Unity Hub projects list.

To do so simply find the project from the list and select Remove from List from the dropdown menu on the right hand side.

Unity Hub- Remove Project from List

Removing a project from the Unity Hub does not delete it, but it does tidy up your list.

This will remove the project from the Unity Hub list but it will not delete the project folder.

If you want to do that, you can simply delete the project folder manually from the Unity Projects folder.

Now I want to hear from you

If you’ve been working in Unity, chances are you’ve had to move your Unity project at some point.

What happened?

Were you able to move the project without breaking it?

And if something did go wrong, what do you wish you had known beforehand that would help someone else right now?

Whatever it is, let me know by leaving a comment below.

Image Attribution

by John Leonard French

Game audio professional and a keen amateur developer.

Get Helpful Game Development Tips, Straight to Your inbox

Get access to exclusive tips & tricks and master game development basics the easy way, with deep-dive tutorials and guides.

Popular Posts

Comments

  1. Thanks a lot ive been working hard on a project and got a new laptop. ive been stuck trying to figure out how to move my project from my old pc to my new laptop. I followed your instructions and I was able to open it without any crashes or bugs, Thanks A LOT

  2. Didn’t work for me. When I moved the whole folder (without deleting anything) the project won’t load. I get a weird half transparent view of the Steam holding room with my project also half visible but I’m in the wrong place and not able to interact with anything… Have tried it a few times now. I wanted to make a copy to experiment with so I can preserve the work I have done so far so this is a bit frustrating. Can’t think why it doesn’t work. I have to add it to Unity hub and open it that way – dont know how else to do it so maybe that’s causing the problem.

    1. Author

      I’d double-check the basics, i.e. make sure you’re using the same version of Unity, that you have any package manager dependencies installed in the new project (this should happen automatically) and that no files have been left out during the transfer. Beyond that, I’d need to know your project better to be able to help. If you don’t mind sharing details about it you can email me at [email protected]

  3. It all worked for a regular project, although how about when copying a cloud collaborated project? I have found that when I copy the project folder, it still retains relationships to the cloud in the original. How can I detach it cleanly from the original cloud?

    Thanks mate!

    1. Author

      Hi Jesse, I might be able to update this article to include managing Cloud projects in the future but, for now, I’d recommend getting in touch with Unity on that one.

  4. Very useful thank you!
    One thing that happened to me as I was working on a scene and then I wanted to open a new scene, thinking it was a “new project”. So Unity doesn’t work that way…and it cleaner my previous project (luckily only testing map and playing around).

    That’s why I was looking for an article like this to create a physical backup somewhere as well. Thanks for the tips!

  5. Hi.

    Thanks for this well put article.

    My project is in my OneDrive folder. I regularly make a copy of the entire project on my F drive for backups. When I open one backup from UnityHub, I find many occurrences of the OneDrive path in files like *.csproj. So I guess it is why when I open a script by clicking inside Unity log console, I get the OneDrive version and not the copied version. Why the paths are not updated? – ‘Visible Meta Files’ is enabled but I do not delete Library and Temp folders.

    1. Author

      That’s interesting. Does this happen only when clicking from the log console? i.e. not an actual script file in the project panel.

      1. Hi John.

        Yes.It does not happen when 2x clicking a script from the project panel. I did not notice this before your question – thanks. I tried with a deleted library folder but the project becomes corrupted with 100s of errors. So I guess something is wrong with my project or something is missing in the copy procedure. Have you tried on your side to open, from a copied project, a script from the stack trace in the console?

        1. Author

          I haven’t tried that but I’ll look into it. If I can recreate it and find a cause I’ll update the article with the extra info.

  6. Thank you for your help. I was having issues as my project was initially saved on the usb to save storage space. The problem is, the usb was getting so hot that it ended up dropping-off in the middle of running Unity. Transfered it to a new location and it was running with no issues 🙂

    1. Author

      Probably a good idea! I’ve found this to be the case when syncing a project with Dropbox too, where syncing the project can cause high CPU usage.

  7. Thank you so much! Now making game backups is more convenient and less space. ^_^ This saves me a lot of back up on my works…

  8. I have a problem that when I open the project on the new computer it stuck on “resolve packages” loading screen and never open it, I tried over and over but it doesn’t work, and It’s very important project for me and I can’t find a way to resolve it, please help!

Leave a Comment