Group Inspector settings reference

Reference for Group Inspector settings that control build paths, load paths, bundle modes, and content update restrictions.

When you select an Addressable group, you can control its settings in the Inspector. To open a group's settings, select the group from its containing folder in the Project window. Alternatively, open the Addressables Groups window (Window > Asset Management > Addressables > Groups), then select a group. The group's settings are displayed in the Inspector.

The Inspector window for the Default Local Group.

Include in build

Enable to include assets in this group in a content build.

Inspect Top Level Settings

Displays the Addressables Asset Settings window for this group.

Content Packing & Loading

The Content Packing & Loading schema is the main Addressables schema used by the default build script, and it defines the settings for building and loading Addressable assets.

Build and Load Paths

Determine where the artifacts for your content builds are created and where the Addressables system loads them at runtime. The build and load path options are defined by variables in a Profile.

Property Description

Build & Load Paths The Profile path pair that defines where the Addressables build system creates artifacts for this group and where the Addressables system loads those artifacts at runtime. Choose a path pair from the list or select <custom> if you want to set the build and load paths separately.

Property	Description
Build & Load Paths	The Profile path pair that defines where the Addressables build system creates artifacts for this group and where the Addressables system loads those artifacts at runtime. Choose a path pair from the list or select `<custom>` if you want to set the build and load paths separately.
Build Path Load Path	Only available if you set Build & Load Paths to `<custom>`. A Profile variable that defines where the Addressables build system creates artifacts for this group, or loads the build artifacts of the group. You can also set a custom string. Use one of the following: LocalBuildPath: Use for assets that you plan to distribute as part of your application installation. RemoteBuildPath: Use for assets that you plan to distribute using a remote hosting service such as Unity Cloud Content Delivery or other Content Delivery Network. Custom: Specify a string as the path for this group.

Build Path

Load Path

Only available if you set Build & Load Paths to <custom>. A Profile variable that defines where the Addressables build system creates artifacts for this group, or loads the build artifacts of the group. You can also set a custom string. Use one of the following:

LocalBuildPath: Use for assets that you plan to distribute as part of your application installation.
RemoteBuildPath: Use for assets that you plan to distribute using a remote hosting service such as Unity Cloud Content Delivery or other Content Delivery Network.
Custom: Specify a string as the path for this group.

When you choose a Profile variable, a preview of the path is displayed in the Path Preview. Components of the path in braces, such as {UnityEngine.AddressableAssets.Addressable.RuntimePath}, indicate that a static variable is used to construct the final path at runtime. That portion of the path is replaced by the current value of the static variable when the Addressables system initializes at runtime.

Warning

If you change the local build or load paths from their default values, you must copy the local build artifacts from your custom build location to the project's StreamingAssets folder before making a Player build. Changing these paths also prevents building your Addressables as part of the Player build.

Advanced Options

Property	Description
Use Defaults	Uses the default compression settings, which is LZ4.
Asset Bundle Compression	The compression type for all bundles produced from the group. Choose from the following: Uncompressed:This option is largest on disk, and fastest to load. If your application has space to spare, consider this option for local content. An advantage of uncompressed bundles is how they handle being patched. If you're developing for a platform where the platform itself provides patching, uncompressed bundles provide the most accurate (smallest) patching. LZ4: A chunk-based compression which provides the ability to load parts of the file without needing to load it in its entirety. LZMA: Use LZMA for all remote content, but not for any local content. It provides the smallest bundle size, but is slow to load. If you store local bundles in LZMA you can create a smaller player, but load times are significantly worse than uncompressed or LZ4. For downloaded bundles, LZMA avoids the slow load time by recompressing the downloaded bundle when storing it in the AssetBundle cache. For more information about AssetBundle caching, refer to AssetBundle compression formats.
Use Asset Bundle Cache	Cache remotely distributed bundles.
Cache Clear Behavior	Controls how old AssetBundles are cleared. Choose from the following: Clear When Space Is Needed In Cache Clear When New Version Loaded
Asset Bundle CRC	Set how to verify a bundle's integrity before loading it: Disabled: Never check bundle integrity. If the application download performs a check on the download before saving to disk, consider setting this property. Enabled, Including Cached: Always check bundle integrity. Use in situations where the data needs to be checked every time such as settings values. Enabled, Excluding Cached: Check integrity of bundles when downloading. This is useful for remote assets. Checking for a change in the file requires the entire AssetBundle to be decompressed and the check processed on the uncompressed bytes. If your AssetBundle contains data that might be tampered with, such as settings values, then you might want to consider enabling CRC checks on saved AssetBundles.
Bundle Naming Mode	Set how to construct the file names of AssetBundles: Append Hash: The file name is a string derived from the group name with bundle hash appended to it. The bundle hash is calculated using the contents of the bundle. No Hash Only Hash File Name Hash: The file name is a hash calculated from the a string derived from the group name.
Include Addresses in Catalog	Include the address strings in the catalog. If you don't use address strings to load assets in the group, you can disable this property to decrease the size of the catalog.
Include GUIDs in Catalog	Include GUID strings in the catalog. You must include GUID strings to access an asset with an `AssetReference`. If you don't use `AssetReference` or GUID strings to load assets, you can disable this property to decrease the size of the catalog.
Include Labels in Catalog	Include label strings in the catalog. If you don't use labels to load assets, you can disable this property to decrease the size of the catalog.
Bundle Mode	Select how to pack the assets in this group into AssetBundles: Pack Together: Create a single AssetBundle containing all assets. Pack Separately: Create an AssetBundle for each primary asset in the group. Subassets, such as sprites in a sprite sheet are packed together. Assets within a folder added to the group are also packed together. Pack Together by Label: Create an AssetBundle for assets sharing the same combination of labels.

Content Update Restriction

The Content Update Restriction schema determines how Check for Content Update Restrictions treats assets in the group. To prepare your groups for a differential content update build rather than a full content build, open the Addressables Groups window, go to Tools and run the Check for Content Update Restrictions command. The tool moves modified assets in any groups with the Prevent Updates property enabled to a new group.

The Prevent Updates property acts in the following way:

Enabled: The tool doesn't move any assets. When you make the update build, if any assets in the bundle have changed, then the entire bundle is rebuilt.
Disabled: If any assets in the bundle have changed, then the Check for Content Update Restrictions tool moves them to a new group created for the update. When you make the update build, the assets in the AssetBundles created from this new group override the versions found in the existing bundles.