By default, Unity imports assets one after another sequentially on the main Unity Editor process. However, you can use the Parallel Import setting to import certain texture and model filesA file containing a 3D data, which may include definitions for meshes, bones, animation, materials and textures. More info
See in Glossary simultaneously. The Parallel Import setting uses multiple processes to import assets simultaneously, which is faster than the default sequential method of importing.
The Parallel Import setting supports only certain types of asset. The specific types of asset which Unity can import in parallel are as follows:
Other types of asset are always imported sequentially during an Asset Database refresh.
Some Asset Database API methods also respect this setting if you use them to import, refresh, or create texture or model assets. These are:
To enable parallel importing:
Parallel importing only happens when the Editor performs a standard Asset Database refresh, which happens when it detects new or modified assets in the Project folder and automatically imports them.
Parallel imports operate in a separate worker instance of the Editor, so any AssetPostprocessor
instances that handle texture or model imports take effect in that instance rather than the main Editor process.
If you enable the Parallel Import setting, be aware that Unity executes the code on multiple threads, so any code you write for post processors must be self-contained, deterministic, and must not change the context it’s running in. For example, don’t use an AssetPostprocessor
to change the Editor settings or create new assets on disk. Following these rules helps your processor code avoid parallel threading issues and ensures that the results are always consistent.
You can use the Asset Pipeline Project settings to control the behaviour of the import worker processes. These settings are project-specific.
You can also control the default values that Unity sets the Desired Import Worker Count for new projects in the Settings window. To do this, go to Settings > Asset Pipeline > Import Worker Count %.
When you create a new project, Unity uses the Import Worker Count % value to assign your project’s Desired Import Worker Count value to the percentage of the number of logical cores available on your system.
For example, if your system has 16 logical cores and this preference is set to 25%, the Desired Import Worker Count for new projects is 4. If you set this value too high, the import worker processes need to compete over other processes and system resources such as reading and writing files. The default value is 25% which suits most situations.
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.