Addressables Preferences reference

Reference for Unity Editor preferences specific to Addressables, covering global settings that apply across all Unity projects.

The Addressables package adds its own section to the Unity Editor Preferences window (File > Settings > Preferences > Addressables).

Preference Description
Warn on Editor usage Logs a warning to the Console when entering Play mode, if any Addressables are used outside of this context in Edit mode.
Debug Build Layout Generates a build layout report as part of the build process. The build report contains a detailed description of each AssetBundle produced by the build. This preference is disabled by default because it increases the total build time. For more information, refer to Create a build report.
Open Build Analysis after build Opens a report window when a content build finishes. In Unity 6.7 and later, this opens the Build Analysis window, which displays the Addressables report. In Unity 6.6 and earlier, this preference is labeled Open Addressables Report after build and opens the Addressables Report window. This preference is available only when Debug Build Layout is enabled.
Build Addressables on build Player Determines how Unity builds Addressables in a Player build:
  • Build Addressables on Player Build: Builds Addressables content as part of the Player build. Building Addressables content together with the Player can be convenient, but increases build time, especially on large projects because this rebuilds the Addressables content even when you haven't modified any assets.
  • Do Not Build Addressables on Player Build: Choose this option if you don't change your Addressables content between most builds. If you modify Addressables content, you must rebuild it manually before building the Player.
These preferences override the global preference for the current project and affect all contributors who build the project.

Additional resources