Create and update labels for projects

This document provides details on how to create and update labels for projects using the Resource Manager API and the Google Cloud console. It provides details on how to understand costs using labels and the services that support labels.

Create labels for projects

Console

To add labels to a single project:

Open the Labelspage in the Google Cloud console.

Open the Labels page
Select your project from the Select a projectdrop-down.
To add a new label entry, click + Add labeland enter a label key and value for each label you want to add.
When you're finished adding labels, click Save.

To add labels for more than one project at the same time:

Open the Manage resourcespage in the Google Cloud console.

Open the Manage resources page
On the Manage resourcespage, select the projects for which you want to add labels.
In the info panel, in the Labelstab, click + Add labeland enter a label key and value for each label you want to add.
When you're finished adding labels, click Save.

After you add labels, you can filter projects by typing a label key or value in the filter box above the projects list. The filter box will suggest keys and values so you can preview results.

Update labels for projects

Console

To update labels for a single project:

Open the Labelspage in the Google Cloud console.

Open the Labels page
Select your project from the Select a projectdrop-down.
Update the labels for your project:
1. To edit a label, click the value that you want to edit, then make your desired changes.
2. To delete a label, hold the pointer over the key or value, then click .
When you're finished updating labels, click Save.

To update labels for more than one project at the same time:

Open the Manage resourcespage in the Google Cloud console.

Open the Manage resources page
On the Manage resourcespage, select the projects for which you want to update labels.
In the info panel, click the Labelstab and update labels for the selected projects:
1. To edit a label, click the value that you want to edit, then make your desired changes.
2. To delete a label, hold the pointer over the key or value, then click .
When you're finished updating labels, click Save.

REST

To update a project's labels, do the following:

Get the project object using the projects.get() method.
Modify the labels that you want to update.
Call the projects.patch method.

The following example updates the label color:blue :

The following code snippet changes the value of the color label from blue to red .

Request:

 PATCH https://cloudresourcemanager.googleapis.com/v3/projects/ PROJECT_NAME 
{
  updateMask=labels
}

Where PROJECT_NAME is the name of the project you want to update.

Request JSON body:

 {
    "labels":
      {
        "color": "red"
      }
}

Response:

 {
    "projects": [
    {
        "name": "projects/123456789012",
        "parent": "folders/123456789012",
        "projectId": "my-project",
        "state": "ACTIVE",
        "displayName": " PROJECT_NAME 
"
        "createTime": "2013-11-13T20:31:53.308Z"
        "updateTime": "2013-11-13T20:35:42.308Z"
        "etag": "BwWUlZ6XEfY="
        "labels": {
            "color": "red"
        },
    }
    ]
}

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-10-30 UTC.