---
title: Stack Labels
description: Organize your stacks with colored labels for quick filtering, grouping, and bulk actions.
---

<Note>
  Stack Labels require a Sencho **Skipper** or **Admiral** license.
</Note>

Stack Labels let you tag your Docker Compose stacks with custom colored labels like `production`, `staging`, or `media-server`. Once labeled, you can filter your stack list, identify stacks at a glance, and run bulk actions on entire groups.

<Frame>
  <img src="/images/stack-labels/sidebar-with-labels.png" alt="Sidebar showing stacks with colored label dots and a label filter pill" />
</Frame>

## Creating labels

### From Settings

1. Open **Settings > Labels**
2. Click **+ New Label**
3. Enter a name and pick a color from the 10 available swatches
4. Click **Create**

<Frame>
  <img src="/images/stack-labels/settings-labels.png" alt="Settings Labels section showing existing labels with assignment counts" />
</Frame>

The label list shows each label's color, name, and how many stacks are currently assigned to it. Hover over a label row to reveal **Edit** and **Delete** buttons.

<Frame>
  <img src="/images/stack-labels/create-label-dialog.png" alt="Create Label dialog with name input and color picker" />
</Frame>

### From the stack context menu

You can also create labels without leaving the sidebar:

1. Right-click any stack in the sidebar
2. Hover over **Labels** to open the submenu
3. Click **Manage labels...** at the bottom to open the Labels section in Settings

### From the three-dot menu

1. Click the three-dot menu on any stack row in the sidebar
2. Click **Labels** to open the label assignment popover
3. Click **Create new label** at the bottom of the popover to create and assign in one step

## Assigning labels to stacks

There are two ways to assign labels:

**Right-click context menu:** Right-click a stack in the sidebar, hover over **Labels**, and click a label to toggle it on or off. A checkmark indicates the label is currently assigned.

<Frame>
  <img src="/images/stack-labels/context-menu-labels.png" alt="Right-click context menu with Labels submenu showing assigned label with checkmark" />
</Frame>

**Three-dot menu popover:** Click the three-dot menu on a stack row, then click **Labels**. The popover shows all labels with checkmarks for assigned ones. Click any label to toggle it.

A stack can have multiple labels. Changes save immediately.

## Filtering by label

### Sidebar

When at least one label exists, a pill bar appears between the search box and the stack list. Click a label pill to filter: only stacks with that label are shown. Click multiple pills to see stacks matching **any** of the selected labels. Click an active pill again to deselect it.

<Frame>
  <img src="/images/stack-labels/sidebar-filtered.png" alt="Sidebar filtered by the prod label showing only matching stacks" />
</Frame>

### Fleet View

The **Tags** filter in the [Fleet View](/features/fleet-view) toolbar lets you filter nodes by stack labels. Selecting a label filters to nodes that contain stacks with that label.

## Bulk actions

Right-click a label pill in the sidebar to access bulk actions:

| Action | Effect |
|--------|--------|
| **Deploy all** | Runs deploy on every stack with that label |
| **Stop all** | Stops every stack with that label |
| **Restart all** | Restarts every stack with that label |

<Frame>
  <img src="/images/stack-labels/bulk-actions-menu.png" alt="Right-click context menu on a label pill showing Deploy all, Stop all, and Restart all options" />
</Frame>

A confirmation dialog shows which stacks will be affected before executing.

## Managing labels

Open **Settings > Labels** to view, edit, and delete your labels.

- **Edit**: Click the pencil icon on a label row to change its name or color
- **Delete**: Click the trash icon to remove the label. A confirmation dialog explains that the label will be removed from all stacks. This cannot be undone.

Label names must be unique per node. There are 10 color options: teal, blue, purple, rose, amber, green, orange, pink, cyan, and slate.
