---
title: "Cloud server tags"
sidebar_label: "Server tags"
sidebar_position: 9
description: "How to add tags to a cloud server and filter servers by tags"
---

import Tabs from '@theme/Tabs'
import TabItem from '@theme/TabItem'
import MoreVerticalIcon from '@selectel/docux/icons/more-vertical'
import PlusIcon from '@selectel/docux/icons/plus'
import CloseIcon from '@selectel/docux/icons/close'
import {TabItemLabel} from '@selectel/docux/components'
import Formbricks from '@theme/MDXComponents/Formbricks'

# Cloud server tags

Tags are labels that can be added to cloud servers. With tags, you can:

* add additional information about a server: image, configuration, server purpose, environment where the server is used, and other characteristics;
* filter servers in the list.

You can add a tag to an [existing cloud server](#add-tag-to-existing-server) or when [creating a server](/cloud-servers/create/create-server.mdx).

## Limitations \{#limitations}

The maximum number of tags for one cloud server is 10.

An added tag cannot be changed — you need to [delete the tag](#delete-tag) and add a new one.

## Add a tag to an existing cloud server \{#add-tag-to-existing-server}

<Tabs queryString="add-tag-to-existing-server">
  <TabItem value="panel" default>
    <TabItemLabel>
      Control panel
    </TabItemLabel>

    1. In the [Control panel](https://my.selectel.ru/vpc/default/servers/), on the top menu, click **Products** and select **Cloud Servers**.

    2. Open the **Servers** tab.

    3. If no tags have been added to the server yet, in the <MoreVerticalIcon /> server menu, select **Add tags**.

    4. If tags have been added, in the <MoreVerticalIcon /> server menu, select **Edit tags**.

    5. Enter the tag name. The maximum tag length is 60 characters. You can use Latin or Cyrillic characters, numbers, and hyphens.

    6. Click <PlusIcon />.

    7. Click **Save**.
  </TabItem>

  <TabItem value="openstack">
    <TabItemLabel>
      OpenStack CLI
    </TabItemLabel>

    1. [Open OpenStack CLI](/cloud-servers/tools/openstack-cli/).

    2. Add a tag to the server:

       ```bash
       openstack server set --tag <tag_name> --os-compute-api-version 2.26 <server>
       ```

       Specify:

       * `<tag_name>` — tag name;
       * `<server>` — server ID or name. You can view the list of servers using the `openstack server list`.
  </TabItem>
</Tabs>

## Filter servers by tag \{#filter-servers}

<Tabs queryString="filter-servers">
  <TabItem value="panel" default>
    <TabItemLabel>
      Control panel
    </TabItemLabel>

    1. In the [Control panel](https://my.selectel.ru/vpc/default/servers/), on the top menu, click **Products** and select **Cloud Servers**.

    2. Open the **Servers** tab.

    3. To view a list of servers with a tag, click the tag in the list. You can filter the server list by multiple tags.
  </TabItem>

  <TabItem value="openstack">
    <TabItemLabel>
      OpenStack CLI
    </TabItemLabel>

    1. [Open OpenStack CLI](/cloud-servers/tools/openstack-cli/).

    2. Filter the servers:

       * view the list of servers with a tag:

       ```bash
       openstack server list --tags <tag_name> --os-compute-api-version 2.26
       ```

       * or view the list of servers without a tag:

       ```bash
       openstack server list --not-tags <tag_name> --os-compute-api-version 2.26
       ```

       Specify `<tag_name>` — tag name.
  </TabItem>
</Tabs>

## Delete a tag \{#delete-tag}

<Tabs queryString="delete-tag">
  <TabItem value="panel" default>
    <TabItemLabel>
      Control panel
    </TabItemLabel>

    You can remove any tag except the `Preemptible` system tag. If you need to make the server non-preemptible, [change the server type](/cloud-servers/manage/change-server-type.mdx).

    1. In the [Control panel](https://my.selectel.ru/vpc/default/servers/), on the top menu, click **Products** and select **Cloud Servers**.

    2. Open the **Servers** tab.

    3. In the <MoreVerticalIcon /> server menu, select **Edit tags**.

    4. In the list of tags, click <CloseIcon />.

    5. Click **Save**.
  </TabItem>

  <TabItem value="openstack">
    <TabItemLabel>
      OpenStack CLI
    </TabItemLabel>

    1. [Open OpenStack CLI](/cloud-servers/tools/openstack-cli/).

    2. Delete the tag:

       ```bash
       openstack server unset --tag <tag_name> --os-compute-api-version 2.26 <server>
       ```

       Specify:

       * `<tag_name>` — tag name;
       * `<server>` — server ID or name. You can view the list of servers using the `openstack server list`.
  </TabItem>
</Tabs>

<Formbricks />