Addressable Asset Settings

You can access the main Addressable system option on the Addressable Asset Settings Inspector (menu: Window > Asset Management > Addressables > Settings).

The Addressables system stores the settings asset in the AddressableSettingsData folder (under your Project Assets folder). If this folder doesn't exist yet, you must initialize the Addressables system from the Groups window (menu: Window > Asset Management > Addressables > Groups).

The Addressable Asset Settings Inspector

The Inspector contains the following sections:

You can click the Manage Groups button to open the Groups window.

Profile


Profile settings

Use the Profile in Use list to choose the active profile. The active profile determines the value of variables used by the Addressables build scripts.

Click the Manage Profiles button to open the Profiles window where you can create new profiles and change profile variables.

See Profiles for more information about profiles.

Diagnostics


Diagnostics settings

Property Function
Send Profiler Events Enables profiler events. You must enable this setting to use the Addressables Event Viewer window.
Log Runtime Exceptions Logs runtime exceptions for asset loading operations (in addition to recording the error to the AsyncOperationHandle.OperationException property).
Tip

By default, Addressable Assets only logs warnings and errors. You can enable detailed logging by opening the Player settings window (menu: Edit > Project Settings... > Player), navigating to the Other Settings > Configuration section, and adding "ADDRESSABLES_LOG_ALL" to the Scripting Define Symbols field.

Catalog


Catalog settings

Settings related to the Addressables Catalog, which maps the address of an asset to its physical location.

Property Function
Player Version Override Overrides the timestamp used to formulate the remote catalog name. If set, the remote catalog is named, Catalog_<Player Version Override>.json. If left blank, then the timestamp is used. Note that when you use a unique remote catalog name for every new build, you can host multiple versions of your content at the same base URL. If you use the same override string for every build, then all players will load the new catalog. Note also that player update builds always use the same remote catalog name as the build they are updating (see Content update builds).
Compress Local Catalog Builds the catalog in a compressed AssetBundle file.
Reduces the storage size of the catalog, but increases the time to build and to load the catalog.
Optimize Catalog Size Reduces the size of the catalog by creating a lookup table for internal IDs. Can increase the time required to load the catalog.

Content Update


Content update settings

Settings that control remote content builds and updates.

Property Function
Only update catalogs manually Disables the automatic check for an updated remote catalog when the Addressables system initializes at runtime. You can manually check for an updated catalog.
Content State Build Path Where to build the content state file produced by the default build script.
Build Remote Catalog Enable to build a remote catalog.
Build & Load Paths Where to build and load the remote catalog. Choose a Profile path pair from the list or select <custom> if you want to set the build and load paths separately.
Only visible when you enable Build Remote Catalog.
Build Path Where to build the remote catalog. Typically, you should use the RemoteBuildPath Profile variable.
Only shown if you set Build & Load Paths to <custom>.
Load Path The URL at which to access the remote catalog. Typically, you should use the RemoteLoadPath Profile variable.
Only shown if you set Build & Load Paths to <custom>.

Downloads


Download settings

Settings that affect catalog and AssetBundle download handling.

Property Function
Custom certificate handler The class to use for custom certificate handling. The list contains all classes in the project that extend UnityEngine.Networking.CertificateHandler.
Max Concurrent Web Requests The system queues any requests beyond this limit. 2-4 concurrent downloads are recommended to reach optimum download speeds.
Catalog Download Timeout How many seconds to wait for a catalog file to download.

Build


Build settings

Settings that affect all builds.

Property Function
Build Addressables on Player Build Whether Unity builds Addressables content as part of your Player build.
• Build Addressables content on Player Build: Always build Addressables content when building the Player.
• Do not Build Addressables content on Player Build: Never build Addressables content when building the Player. (If you modify Addressables content, you must rebuild it manually before building the Player.)
• Use global Settings (stored in preferences): Use the value specified in the Unity Editor Preferences (under Addressables).

The first two options override the global Preference for the current Project and affect all contributors who build the Project. Otherwise, the global, Preferences value applies to all Unity projects. See Building content for more information.
Ignore Invalid/Unsupported Files in Build If enabled, the Addressables build script excludes invalid or unsupported files rather than aborting the build.
Unique Bundle IDs Whether to produce a unique name for a bundle in every build. See Unique Bundle IDs for more information.
Contiguous Bundles Produces a more efficient bundle layout. If you have bundles produced by Addressables 1.12.1 or earlier, disable this option to minimize bundle changes.
Non-Recursive Dependency Calculation Enable this option to improve build times and reduce runtime memory overhead when assets have circular dependencies. Examples:
• A prefab assigned to Bundle A references a material assigned to Bundle B. If this option is disabled, Unity needs to calculate the material's dependencies twice, once for each bundle. If this option is enabled, Unity only needs to calculate the material's dependencies once, for Bundle B.
• Many scenes reference the same material. If this option is disabled, Unity opens each scene to calculate shader usage, which is a costly operation. If this option is enabled, Unity only loads the material and doesn't need to open any scenes for dependency calculation.

This option is enabled by default when using Unity version 2021.2 or later. Disabling this option invalidates previously built bundles because the rebuilt bundles will have a different build layout. Therefore this option should remain enabled unless builds have been shipped.

Some circular dependencies can fail to load when the option is enabled because the referenced asset is always assigned to the same bundle location, even when more content is added to the build. This issue often occurs for Monoscripts. Building the MonoScript bundle (see MonoScript Bundle Naming Prefix) can help resolve these load failures.
Shader Bundle Naming Prefix How to name the bundle produced for Unity shaders.
MonoScript Bundle Naming Prefix How to name the bundle containing all MonoScripts. The bundle ensures that Unity loads all Monoscripts before any MonoBehaviors can reference them. It also decreases the number of duplicated or complex Monoscript dependencies and so, reduces runtime memory overhead.
Strip Unity Version From AssetBundles Whether to remove the Unity version from the bundle header.
Disable Visible Sub Asset Representations Enable this option to improve build times if you do not use subobjects directly (Sprites, sub-meshes, etc).

Build and Play Mode Scripts


Configured build and Play mode scripts

Configures the IDataBuilder scripts available in the project. If you create a custom Build or Play Mode script, you must add it to this list before you can use it.

The Addressables packages contains a few build scripts that handle the default build processes and provide different ways to access your data in Play mode. You can find these scripts in the AddressableAssetData/DataBuilders folder.

Note

Build and Play Mode scripts are ScriptableObject assets. Follow the instructions in the ScriptableObject manual page to create a ScriptableObject asset for a Build or Play Mode script.

To add a custom script, click on the + button and select the ScriptableObject asset which represents the desired script from the file panel.

See Custom Build Scripting for more information about custom scripts.

Asset Group Templates


Configured group templates

Defines the list of templates that you can use to create new groups. When you create a new template, you must add it to this list before you can use it.

The Addressables package contains one template that includes the schemas used by the default build scripts. You can find the template in the AddressableAssetData/AssetGroupTemplates folder.

Note

Group templates are ScriptableObject assets. Follow the instructions in the ScriptableObject manual page to create a ScriptableObject asset for a group template.

To add a custom template, click on the + button and select the ScriptableObject asset which represents the desired template from the file panel.

See Group templates for information on creating custom templates.

Initialization object list


Configured InitializationObjects

Configures the initialization objects for the project. Initialization objects are ScriptableObject classes that implement the IObjectInitializationDataProvider interface. You can create these objects to pass data to the Addressables initialization process at runtime.

Note

Initialization objects are ScriptableObject assets. Follow the instructions in the ScriptableObject manual page to create a ScriptableObject asset for a initialization object.

To add an initialization object, click on the + button and select the ScriptableObject asset which represents the desired object from the file panel.

See Customizing initialization for more information.