title	description	ms.date	monikerRange	author	ms.author
Cache@2 - Cache v2 task	Cache files between runs.	10/07/2025	=azure-pipelines \|\| =azure-pipelines-server \|\| =azure-pipelines-2022.2 \|\| =azure-pipelines-2022.1 \|\| =azure-pipelines-2022 \|\| =azure-pipelines-2020.1 \|\| =azure-pipelines-2020	ramiMSFT	rabououn

Cache@2 - Cache v2 task

:::moniker range="<=azure-pipelines"

Improve build performance by using this task to cache files, such as dependencies, between pipeline runs. To add the task, search for Cache (cache files between runs) in Classic pipelines or the YAML editor. See Cache task: how it works and Reduce build time using caching for specific examples and more details.

:::moniker-end

Syntax

:::moniker range="<=azure-pipelines"

# Cache v2
# Cache files between runs.
- task: Cache@2
  inputs:
    key: # string. Required. Key. 
    path: # string. Required. Path. 
    #cacheHitVar: # string. Cache hit variable. 
    #restoreKeys: # string. Additional restore key prefixes.

:::moniker-end

Inputs

:::moniker range="<=azure-pipelines"

key - Key
string. Required.

The key (unique identifier) for the cache. This should be a string that can be segmented using |. File paths can be absolute or relative to $(System.DefaultWorkingDirectory).

While there is no defined maximum number of segments for a key, if you are getting cache misses, try using a shorter key with fewer segments, for example by creating a new key that is a hash of your segments.

:::moniker-end

:::moniker range="<=azure-pipelines"

path - Path
string. Required.

The path of the folder to cache. Can be fully qualified or relative to $(System.DefaultWorkingDirectory). Wildcards are not supported. Variables are supported.

:::moniker-end

:::moniker range="<=azure-pipelines"

cacheHitVar - Cache hit variable
string.

The variable to set based on cache restoration. It will be true when the cache is restored (i.e. a cache hit), inexact on a restore key cache hit (based on restoreKeys) or false if there is a cache miss.

:::moniker-end

:::moniker range="<=azure-pipelines"

restoreKeys - Additional restore key prefixes
string.

The additional restore key prefixes that the task uses if the primary key misses. This can be a newline-delimited list of key prefixes.

:::moniker-end

Task control options

All tasks have control options in addition to their task inputs. For more information, see Control options and common task properties.

Output variables

:::moniker range="<=azure-pipelines"

None.

:::moniker-end

Remarks

Improve build performance by caching files, like dependencies, between pipeline runs.

Requirements

:::moniker range="<=azure-pipelines"

Requirement	Description
Pipeline types	YAML, Classic build
Runs on	Agent, DeploymentGroup
Demands	None
Capabilities	This task does not satisfy any demands for subsequent tasks in the job.
Command restrictions	Any
Settable variables	Any
Agent version	2.160.0 or greater
Task category	Utility

:::moniker-end

See also

Pipeline Caching
Cache NuGet packages