The following sections explain how to troubleshoot and prevent problems with the Unity Editor in different situations. In general, make sure your computer meets all the system requirements, is up-to-date, and that you have the required user permissions in your system. Also, make backups regularly to protect your projects.
You can install different versions of the Editor in different folders. However, make sure you backup your projects as these might be upgraded by a newer version, and you won’t be able to open them in an older version of Unity. Refer to installing Unity for further information.
Licenses of add-ons are valid only for the Unity versions that share the same major number, for example 3.x and 4.x. If you upgrade to a minor version of Unity, for example 4.0 to 4.1, the add-ons will be kept.
The Unity Hub is the primary method for all license management operations. For information about all license activation methods, refer to License activation methods.
If you experience issues activating your license, refer to License Troubleshooting.
If you still have problems activating your license or logging in to your user account, contact Unity Support.
If Unity crashes when starting then firstly make sure that your computer meets the minimal system requirements. Also update to the latest graphic and sound drivers.
If you get disk write errors, check your user account restrictions. When in macOS, note the “root user” is not recommended and Unity hasn’t been tested in this mode. Unity must always have write permissions for its folders, but if you are granting them manually check these folders:
On Windows:
%AllUsersProfile%\Unity
(typically C:\ProgramData\Unity)C:\Documents and Settings\<user>\Local Settings\Application Data\Unity
C:\Users\<user>\AppData\Local\Unity
On macOS:
/Library/Application Support/Unity
~/Library/Logs/Unity
Some users have experienced difficulties when using hard disks formatted with non-native partitions, and using certain software to translate data between storage devices.
Corrupt fonts can crash Unity, you can find damaged files following these steps:
On Windows:
On macOS:
The system might have resources constrained, for example running in a virtual machine. Use the Task Manager to find processes consuming lots of memory.
Unity might try to open a project that is corrupt, and this might include the default sample project. If this is the case, rename or move the folder of the project. After Unity starts correctly, you can restore the project’s folder if wished.
In the event of a corrupt installation, you might need to reinstall Unity. Refer to the instructions below.
In Windows, there might be problems like installation errors, registry corruption, conflicts, and other issues. For example, error 0xC0000005 means the program has attempted to access memory that it shouldn’t. If you added new hardware or drivers recently, remove and replace the hardware to determine if it’s causing the problem. Run diagnostics software and check information on troubleshooting the operating system.
If the Editor runs slowly or crashes, particularly on builds, this might be caused by all of the available system resources being consumed. Close all other applications when you build the project. Clean up the system using its utilities, and consult the Task Manager (Windows) or Activity Monitor (MacOS) to find out if there are processes using lots of resources, for example memory. Sometimes virus protection software can slow down or even block the file system with its scanning process.
There are many factors that can destroy a project. The recommended best practice is that you constantly backup your projects to prevent unfortunate accidents. When in macOS, activate Time Machine using an external hard disk reserved for this sole purpose. After a loss you can try any of the file recovery utilities that exist, but sometimes this is irreversible.
Follow these steps to reinstall the Editor:
Uninstall Unity. When in macOS, drag the Unity app to trash.
Delete these files if present:
%AllUsersProfile%\Unity\
(typically C:\ProgramData\Unity)/Library/Application Support/Unity/
Restart the computer.
Download the latest version from our website, since your original install might be corrupt: http://unity3d.com/unity/download/archive
Reinstall Unity.
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.
When you visit any website, it may store or retrieve information on your browser, mostly in the form of cookies. This information might be about you, your preferences or your device and is mostly used to make the site work as you expect it to. The information does not usually directly identify you, but it can give you a more personalized web experience. Because we respect your right to privacy, you can choose not to allow some types of cookies. Click on the different category headings to find out more and change our default settings. However, blocking some types of cookies may impact your experience of the site and the services we are able to offer.
More information
These cookies enable the website to provide enhanced functionality and personalisation. They may be set by us or by third party providers whose services we have added to our pages. If you do not allow these cookies then some or all of these services may not function properly.
These cookies allow us to count visits and traffic sources so we can measure and improve the performance of our site. They help us to know which pages are the most and least popular and see how visitors move around the site. All information these cookies collect is aggregated and therefore anonymous. If you do not allow these cookies we will not know when you have visited our site, and will not be able to monitor its performance.
These cookies may be set through our site by our advertising partners. They may be used by those companies to build a profile of your interests and show you relevant adverts on other sites. They do not store directly personal information, but are based on uniquely identifying your browser and internet device. If you do not allow these cookies, you will experience less targeted advertising. Some 3rd party video providers do not allow video views without targeting cookies. If you are experiencing difficulty viewing a video, you will need to set your cookie preferences for targeting to yes if you wish to view videos from these providers. Unity does not control this.
These cookies are necessary for the website to function and cannot be switched off in our systems. They are usually only set in response to actions made by you which amount to a request for services, such as setting your privacy preferences, logging in or filling in forms. You can set your browser to block or alert you about these cookies, but some parts of the site will not then work. These cookies do not store any personally identifiable information.