explanation operate

Labels

Labels are user-defined key-value pairs that you can attach to your resources to organize and categorize them however you make sense of them.

A label might describe ownership, a project, an environment grouping, or anything else that helps you find and group related resources. Nais does not assign any special meaning to your labels — they are yours to use as you see fit.

How labels work on Nais

Labels on Nais are regular Kubernetes labels. You can use any key and value that follows the standard Kubernetes label syntax.

Plaintext

When you set a label on a resource, Nais keeps it verbatim and propagates it to the underlying Kubernetes resources that the resource owns. For a workload, this means the label is also applied to the resources Nais generates on your behalf.

Hidden labels

Nais surfaces all labels on your resources, except for a few that Nais and Kubernetes manage internally. The following labels are hidden in Nais Console and the Nais API:

  • the app label
  • the team label
  • any label whose key contains the substring nais.io/

These labels are still present on the underlying Kubernetes resources — they are only hidden from the Nais-managed views.

Where you can use labels

You can define labels on any of the Kubernetes resources that Nais supports, under metadata.labels.

In addition, you can add and edit labels directly from Nais Console for:

Related pages

🎯 Add labels to your resources

📚 Label reference