// Module included in the following assemblies:
// * installing/installing_gcp/installing-gcp-customizations.adoc

:_mod-docs-content-type: CONCEPT
[id="installing-gcp-user-defined-labels-and-tags_{context}"]
= Managing user-defined labels and tags for {gcp-short}

{gcp-first} provides labels and tags that help to identify and organize the resources created for a specific {product-title} cluster, making them easier to manage.

You can define labels and tags for each {gcp-short} resource only during {product-title} cluster installation.

[IMPORTANT]
====
User-defined labels and tags are not supported for {product-title} clusters upgraded to {product-title} {product-version}.
====

[NOTE]
====
You cannot update the tags that are already added. Also, a new tag-supported resource creation fails if the configured tag keys or tag values are deleted.
====

.User-defined labels

User-defined labels and {product-title} specific labels are applied only to resources created by {product-title} installation program and its core components such as:

* {gcp-short} filestore CSI Driver Operator
* {gcp-short} PD CSI Driver Operator
* Image Registry Operator
* Machine API provider for {gcp-short}

User-defined labels are not attached to the resources created by any other Operators or the Kubernetes in-tree components.

User-defined labels and {product-title} labels are available on the following {gcp-short} resources:

* Compute disk
* Compute forwarding rule
* Compute image
* Compute instance
* DNS managed zone
* Filestore backup 
* Filestore instance
* Storage bucket

.Limitations to user-defined labels

* Labels for `ComputeAddress` are supported in the {gcp-short} beta version. {product-title} does not add labels to the resource.

.User-defined tags

User-defined tags are applied only to resources created by {product-title} installation program and its core components, such as the following resources:

* {gcp-short} FileStore CSI Driver Operator
* {gcp-short} PD CSI Driver Operator
* Image Registry Operator
* Machine API provider for {gcp-short}

User-defined tags are not attached to the resources created by any other Operators or the Kubernetes in-tree components.

User-defined tags are available on the following {gcp-short} resources:

* Compute disk
* Compute instance
* Filestore backup
* Filestore instance
* Storage bucket

.Limitations to the user-defined tags

* Tags must not be restricted to particular service accounts, because Operators create and use service accounts with minimal roles.
* {product-title} does not create any key and value resources of the tag.
* {product-title} specific tags are not added to any resource.


[role="_additional-resources"]
.Additional resources

* For more information about identifying the `OrganizationID`, see: link:https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id[OrganizationID]
* For more information about identifying the `ProjectID`, see: link:https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects[ProjectID]
* For more information about labels, see link:https://cloud.google.com/resource-manager/docs/labels-overview[Labels Overview].
* For more information about tags, see link:https://cloud.google.com/resource-manager/docs/tags/tags-overview[Tags Overview].
