Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


Build Pipeline project settings reference

Configure build history retention and the build history folder.
Read time 1 minuteLast updated 24 days ago

View and edit the settings to configure how Unity stores and retains build history.
To open these settings, go to Edit > Project Settings > Build Pipeline.
These settings are stored per-user, per-project in
UserSettings/BuildPipelineSettings.asset
.
To view the contents of the Build History, open the Build Analysis window (Window > Analysis > Build Analysis).

Build Pipeline settings

The Build Pipeline project settings contain the following settings.

Setting

Description

Build History Folder PathSets the folder where Unity stores build history data. By default, this is
Library/BuildHistory
. Unity generates this folder when you start a build and it contains metadata related to the build process. Select Change Build History Path to perform the following operations:
  • Change Build History Folder Location: Opens a dialog to select a different folder for the build history. Specifying a new location doesn't move any existing build history files.
  • Show in Explorer (Windows) Reveal in Finder (macOS) Open Containing Folder (Linux): Opens a file browser window in the build history folder.
  • Reset Build History folder Location: Reverts the build history folder to
    Library/BuildHistory
    .
Build History LimitSets the maximum number of builds to keep in Build History. When a new build pushes the count over this limit, Unity removes the oldest entries at the start of the next build. The minimum value is 1. Changes take effect on the next build and the existing history isn't pruned when you change this value.

Additional resources