Unity packages are a handy way of sharing and re-using Unity projects and collections of assets;
Unity Standard Assets and items on the Unity Asset Store are supplied in packages, for example.
Packages are collections of files and data from Unity projects, or elements of projects,
which are compressed and stored in one file, similar to Zip files.
Like Zip files, a package maintains its original directory structure when it is unpacked,
as well as meta-data about assets (such as import settings and links to other assets).
In Unity, the menu option Export Package compresses and stores the collection, while Import Package unpacks the collection into your currently open Unity project.
This page contains information on:
You can import Standard Asset Packages, which are asset collections pre-made and supplied with Unity, and Custom Packages, which are made by people using Unity.
Choose Assets > Import Package > to import both types of package.
Unity ‘Standard Assets’ consist of several different packages: 2D, Cameras, Characters, CrossPlatformInput, Effects, Environment, ParticleSystems, Prototyping, Utility, Vehicles.
To import a new Standard Asset package:
Open the project you want to import assets into.
Choose Assets > Import Package > plus the name of the package you want to import, and the Import Unity Package dialog box displays, with all the items in the package pre-checked, ready to install. (See Fig 2: New install Import Unity Package Dialog Box.)
Select Import and Unity puts the contents of the package into a Standard Asset folder, which you can access from your Project View.
You can import custom packages which have been exported from your own projects or from projects made by other Unity users.
To import a new custom package:
Open the project you want to import assets into.
Choose Assets > Import Package > Custom Package… to bring up up File Explorer (Windows) or Finder (Mac).
Select the package you want from Explorer or Finder, and the Import Unity Package dialog box displays, with all the items in the package pre-checked, ready to install. (See Fig 4: New install Import Unity Package dialog box.)
Select Import and Unity puts the contents of the package into the Assets folder, which you can access from your Project View.
Use Export Package to create your own Custom Package.
HINT: When exporting a package Unity can export all dependencies as well. So, for example, if you select a Scene and export a package with all dependencies, then all models, textures and other assets that appear in the scene will be exported as well. This can be a quick way of exporting a bunch of assets without manually locating them all.
Sometimes you may want to change the contents of a package and create a newer, updated version of your asset package. To do this:
Select the asset files you want in your package (select both the unchanged ones and the new ones).
Export the files as described above in Export Package, above.
NOTE: You can re-name an updated package and Unity will recognise it as an update, so you can use incremental naming, for example: MyAssetPackageVer1, MyAssetPackageVer2.
HINT: It is not good practise to remove files from packages and then replace them with the same name: Unity will recognise them as different and possibly conflicting files and so display a warning symbol when they are imported. If you have removed a file and then decide to replace it, it is better to give it a different, but related name to the original.
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?
Is something described here not working as you expect it to? It might be a Known Issue. Please check with the Issue Tracker at issuetracker.unity3d.com.
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:
Thanks for helping to make the Unity documentation better!