Version: 2020.3
Asset packages
Importing local asset packages
How do you use documentation throughout your workflow? Share your experience with us by taking this survey.

Creating your own asset packages

Note: If you want to share scenesA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary
, samples, tools, or other assets, Unity recommends creating your own Unity package. However, you can also use the asset packageA collection of files and data from Unity projects, or elements of projects, which are compressed and stored in one file, similar to Zip files, with the .unitypackage extension. Asset packages are a handy way of sharing and re-using Unity projects and collections of assets. More info
See in Glossary
(.unitypackage) format. For example, you might want to create an asset package to copy a number of assets or an entire Scene from one project to another.

Follow the instructions in this section for exporting asset packages from the Assets menu in the Unity Editor.

Note: If your assets are high quality and you believe other users would find them useful, follow the instructions in the documentation for Publishing to the Asset Store to create a package draft and upload it to the Asset Store

To create your own custom asset package:

  1. Open the project you want to export assets from.

  2. Choose AssetsAny media or data that can be used in your game or project. An asset may come from a file created outside of Unity, such as a 3D Model, an audio file or an image. You can also create some asset types in Unity, such as an Animator Controller, an Audio Mixer or a Render Texture. More info
    See in Glossary
    > Export Package from the menu to open the Exporting package dialog box.

    Exporting Package dialog box
    Exporting Package dialog box
  3. In the dialog box, select the assets you want to include in the package by clicking on the boxes so they are checked.

  4. Leave Include dependencies enabled to auto-select any assets used by the assets you already selected.

  5. Click Export to bring up the file explorer, and choose where you want to store your package file.

  6. Name and save the package anywhere you like.

Tip: When exporting a package Unity can export all dependencies
See in Glossary
as well. So, for example, if you select a Scene and export a package with all dependencies, then Unity exports all Models, Textures and other assets that appear in the Scene as well. This can be a quick way of exporting several assets without manually locating them all.

Re-exporting asset packages

If you want to change the contents of an asset package and create a newer, updated version of your asset package, select the asset files you want in your package (both the unchanged ones and the new ones). Then follow the instructions above to export the files.

Naming strategies

Rename your updated package using incremental names: for example, MyAssetPackageVer1, MyAssetPackageVer2. Unity recognizes it as an update, so you should use a naming convention that is clear for you and anyone you share it with.

Warning: Don’t remove files from asset packages and then add different files with the same name. Unity uses unique IDs to track files, so it recognizes them as different and possibly conflicting files. In these cases, Unity displays a warning symbol when importing them. If you have removed a file and then decide to replace it, rename it something else, even if it is close to the original name.

Asset packages
Importing local asset packages