Documentation

Support

Build Automation

DevOps

Build Automation REST API

Build Automation Editor Package

Open Unity Dashboard

Build Automation

Choose Build output compression level

Explore build output compression levels to balance speed and file size.
Read time 1 minuteLast updated 16 hours ago
Unity Build Automation (UBA) compresses some build outputs after the Unity build completes and before UBA uploads the build to storage buckets. UBA uses compression level 1 by default. Usually, builds Unity produces are already compressed. Compression level 1 is the compression level with the most efficient in regards to compression time and final compressed file size. However, depending on factors such as your project, your platform, and your Unity build output compression technique (
None
, 
LZ4
, or 
LZ5 HC
), you might want to change the final build output compression levels. In general, lower compression levels reduce build outputs compression time, but result in larger final compressed files. You can edit your compression level to test which level is best for your project. For example, you can evaluate compression time and final compressed file size to find the optimal build output compression level for your project and performance thresholds.

Compressed build output files

The following build output files are compressed and will be affected by the build output compression level setting:
  • Desktop, WebGL and console builds
  • Symbol files
  • XCode archives and projects

Configure Build output compression level

You can configure the build output compression level at two levels: for a specific project, or for a build target configuration.

Configure Build output compression level for a project

  1. In your Unity Dashboard, select DevOps > Build Automation > Settings.
  2. Click on the Project configurations tab.
  3. In the Build output card, select the Build output compression level you want to use.
  4. Click Save.

Configure Build output compression level for a Build Target Configuration

  1. In your Unity Dashboard, select DevOps > Build Automation > Configurations.
  2. Select the edit icon on the build configuration you want to edit and go to Advanced Settings.
  3. Select the Build output compression level in the Build Output card.
  4. The default option is Use project's build output compression level, which inherits the compression level from your project settings, but you can override this setting for the current build target.
  5. Click Save changes.