title	Promote packages and manage feed views
description	Learn how to promote packages to a specific view and manage feed views in Azure Artifacts.
ms.assetid	EB40D23E-1053-4EBF-9D1D-19CF1BBAF1C6
ms.service	azure-devops-artifacts
ms.topic	how-to
ms.date	01/22/2026
monikerRange	<=azure-devops

Promote packages and manage feed views

[!INCLUDE version-lt-eq-azure-devops]

Feed views enable developers to control package visibility by sharing some packages while keeping others private. Each view filters the feed to display a subset of packages based on specific criteria defined for that view.

By default, Azure Artifacts includes three views: @Local, @Prerelease, and @Release. The @Local view is the default and contains all published packages, along with packages saved from upstream sources. All views support NuGet, npm, Maven, Python, Cargo, and Universal Packages.

You can change the default view in Feed Settings > Views. However, changing the default view doesn’t allow direct publishing to that view. Packages can only be published to the base feed, where they're available in the @Local view.

Prerequisites

Product	Requirements
Azure DevOps	- An Azure DevOps organization and a project. - An Azure Artifacts feed.

Promote a package to a view

Note

You must be a Feed Publisher (Contributor) or a Feed Owner to promote packages to a view.

Follow these steps to promote a package to a specific view in your feed:

Sign in to your Azure DevOps organization, then navigate to your project.
Select Artifacts, then select your feed from the dropdown menu.
Select the package you want to promote, then select Promote.
Select a view from the dropdown menu, then select Promote once more.

:::image type="content" source="media/promote-packages-select-view.png" alt-text="A screenshot displaying how to promote a package to a view in Azure Artifacts.":::

Important

Azure Artifacts doesn't support package demotion. Once a package is promoted, it can't be reverted to a previous view.

Promote a package using the REST API

To promote a package using the REST API, send a PATCH request with a request body formatted as a JSON Patch document. This appends the target view (for example, Prerelease) to the package’s views array.

Sign in to Azure DevOps, then navigate to your project.
Create a Personal Access Token with Packaging > Read, write, & manage scope.
Copy the endpoint URL, replace it in one of the examples below (PowerShell or curl), and run the command to promote your package to the desired view.

::: moniker range="azure-devops"

NuGet

Organization-scoped feed:

https://pkgs.dev.azure.com/{organization}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.2-preview.1

Project-scoped feed:

https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.2-preview.1

See JsonPatchOperation and NuGet - Update Package Version for more details.

Npm

Organization-scoped feed:

https://pkgs.dev.azure.com/{organization}/_apis/packaging/feeds/{feedId}/npm/{packageName}/versions/{packageVersion}?api-version=7.2-preview.1

Project-scoped feed:

https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/npm/{packageName}/versions/{packageVersion}?api-version=7.2-preview.1

See JsonPatchOperation and Npm - Update Package for more details.

Python

Organization-scoped feed:

https://pkgs.dev.azure.com/{organization}/_apis/packaging/feeds/{feedId}/pypi/packages/{packageName}/versions/{packageVersion}?api-version=7.2-preview.1

Project-scoped feed:

https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/pypi/packages/{packageName}/versions/{packageVersion}?api-version=7.2-preview.1

See JsonPatchOperation and Python - Update Package Version for more details.

Maven

Organization-scoped feed:

https://pkgs.dev.azure.com/{organization}/_apis/packaging/feeds/{feed}/maven/groups/{groupId}/artifacts/{artifactId}/versions/{version}?api-version=7.2-preview.1

Project-scoped feed:

https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feed}/maven/groups/{groupId}/artifacts/{artifactId}/versions/{version}?api-version=7.2-preview.1

See JsonPatchOperation and Maven - Update Package Version for more details.

Cargo

Organization-scoped feed:

https://pkgs.dev.azure.com/{organization}/_apis/packaging/feeds/{feedId}/cargo/packages/{packageName}/versions/{packageVersion}?api-version=7.2-preview.1

Project-scoped feed:

https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/cargo/packages/{packageName}/versions/{packageVersion}?api-version=7.2-preview.1

See JsonPatchOperation and Cargo - Update Package Version for more details.

Universal Packages

Organization-scoped feed:

https://pkgs.dev.azure.com/{organization}/_apis/packaging/feeds/{feedId}/upack/packages/{packageName}/versions/{packageVersion}?api-version=7.2-preview.1

Project-scoped feed:

https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/upack/packages/{packageName}/versions/{packageVersion}?api-version=7.2-preview.1

See JsonPatchOperation and Universal Packages - Update Package Version for more details.

::: moniker-end

::: moniker range="azure-devops-2022"

NuGet

Collection-scoped feed:

https://{instance}/{collection}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1

Project-scoped feed:

https://{instance}/{collection}/{project}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1

See JsonPatchOperation and NuGet - Update Package Version for more details.

Npm

Collection-scoped feed:

https://{instance}/{collection}/_apis/packaging/feeds/{feedId}/npm/packagesbatch?api-version=7.1

Project-scoped feed:

https://{instance}/{collection}/{project}/_apis/packaging/feeds/{feedId}/npm/packagesbatch?api-version=7.1

See JsonPatchOperation and Npm - Update Package for more details.

Maven

Collection-scoped feed:

https://{instance}/{collection}/_apis/packaging/feeds/{feed}/maven/groups/{groupId}/artifacts/{artifactId}/versions/{version}?api-version=7.1-preview.1

Project-scoped feed:

https://{instance}/{collection}/{project}/_apis/packaging/feeds/{feed}/maven/groups/{groupId}/artifacts/{artifactId}/versions/{version}?api-version=7.1-preview.1

See JsonPatchOperation and Maven - Update Package Version for more details.

::: moniker-end

Examples

Replace the placeholders with your personal access token, endpoint URL, and view name, then run the command to promote your package to the desired view:

PowerShell

$env:PAT = "YOUR_PERSONAL_ACCESS_TOKEN"
$uri = "YOUR_URL"
$headers = @{
    "Content-Type" = "application/json"
    Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$env:PAT"))
}
$body = @{
    views = @{
        op    = "add"
        path  = "/views/-"
        value = "YOUR_VIEW_NAME"
    }
} | ConvertTo-Json

Invoke-RestMethod -Uri $uri -Method Patch -Headers $headers -Body $body

curl

PAT="YOUR_PERSONAL_ACCESS_TOKEN"
ENCODED_PAT=$(echo -n ":$PAT" | base64 | tr -d '\n')
$ curl -X PATCH "YOUR_ENDPOINT_URL" \
-H "Content-Type: application/json" \
-H "Authorization: Basic $ENCODED_PAT" \
-d '{
    "views":  {
                  "path":  "/views/-",
                  "op":  "add",
                  "value":  "YOUR_VIEW_NAME"
              }
    }'

::: moniker range="azure-devops"

Note

All feed views in a public project are publicly accessible and can be viewed by anyone on the internet.

::: moniker-end

Manage views

By default, Azure Artifacts includes three views: @Local, @Prerelease, and @Release. You can also create additional views and manage existing ones by renaming or deleting them from your feed’s settings

Sign in to your Azure DevOps organization, then navigate to your project.
Select Artifacts, then select your feed from the dropdown menu.
Select the gear icon :::image type="icon" source="../../media/icons/gear-icon.png" border="false"::: to open your feed's settings.

:::image type="content" source="../media/feed-settings.png" alt-text="A screenshot showing how to access feed settings in Azure Artifacts.":::
Select Views, choose a view, and then select Edit to modify it. To create a new view, select Add view.

:::image type="content" source="./media/manage-views.png" alt-text="A screenshot showing how to add, edit, or delete feed views.":::
Select Save when you're done.

::: moniker range="azure-devops"

Important

For public feeds, if you change the access permissions of a view to Specific people, that view is no longer available as an upstream source.

::: moniker-end

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Promote packages and manage feed views

Prerequisites

Promote a package to a view

Promote a package using the REST API

NuGet

Npm

Python

Maven

Cargo

Universal Packages

NuGet

Npm

Maven

Examples

PowerShell

curl

Manage views

Related content

FilesExpand file tree

views.md

Latest commit

History

views.md

File metadata and controls

Promote packages and manage feed views

Prerequisites

Promote a package to a view

Promote a package using the REST API

Examples

Manage views

Related content