Documentation

​
​

Development

User Acquisition

Monetization

Industry

Build Automation

DevOps

Build Automation REST API

Build Automation Editor Package

Open Unity Dashboard

Build Automation

​
​
Build Automation
  • Overview
  • Get started with Build Automation
  • Build Automation Glossary
  • Build configuration
  • Advanced build configuration
  • Run builds
  • Build results
  • Optimize build speed
    • Optimize build speed overview
    • Choose a machine specification
    • Select a caching strategy
    • Select build output compression level
    • Choose a Git Executable
  • Manage artifact retention rules
  • Manage concurrent builds
  • Sign build artifacts
  • Build Automation integrations
  • Build Automation API
  • Build Automation Editor Package
  • Reference
  1. Unity Build Automation
  3. Optimize build speed

Choose Build output compression level

Explore build output compression levels to balance speed and file size.
Read time 2 minutes
Last updated a year 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

Note
This option overrides the project level Build output compression level setting for the specific build target.
  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.
Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page

    • Compressed build output files

    • Configure Build output compression level

      • Configure Build output compression level for a project

      • Configure Build output compression level for a Build Target Configuration

Report a problem with this page