> ## Documentation Index
> Fetch the complete documentation index at: https://docs.novacula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizing nodes

> Find nodes fast: search, filter, group by, and tag and group your fleet from the Nodes list

The **Nodes** list is your starting point for everything node-related across the organization. As a fleet grows, four controls keep it manageable: **search**, **filters**, **group by**, and your own **tags** and **groups**. They combine freely, and your choices stick — the list remembers them per organization in this browser.

## Search

Use the **Search nodes...** box (top right of the list) to jump to a node by typing. It matches, case-insensitively, on the node name, its chain and network, the executor it runs on, and any tags or group you've applied. Matches are partial, so `eth` finds every Ethereum node.

## Filter

Click **Filter** to add a condition. Each condition becomes a pill with a field, an operator, and one or more values; remove a pill with its **X**. Add as many as you need — they all apply at once (logical AND).

| Filter                      | Use it to                                                                                                                                                     |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chain**                   | Limit to one or more chains (Bitcoin, Ethereum, Igra, Ink). Only chains you actually run appear.                                                              |
| **Phase**                   | Limit to one or more [node states](/docs/nodes/node-lifecycle#node-states) — the fastest way to surface everything in **Error** or stuck in **Provisioning**. |
| **Executor**                | Limit to nodes on specific executors. Handy when investigating one host or planning a migration off it.                                                       |
| **Recent change**           | Show only nodes with (or without) a recent lifecycle change.                                                                                                  |
| **Created** / **Last seen** | Filter by date — `is`, `before`, `after`, `between`, or empty/not-empty.                                                                                      |
| **Tags**                    | Limit by the tags you've applied (see below).                                                                                                                 |
| **Group**                   | Limit to nodes in a chosen group.                                                                                                                             |

Multi-value filters offer operators like **is any of**, **is not any of**, **includes all**, and **excludes all**, so you can express "Ethereum or Ink" or "tagged `prod` but not `canary`" directly.

## Group by

The **Group by** control collapses the table into sections by any groupable column — Chain, Executor, Phase, Group, or Tags. Grouping by **Phase** gives an at-a-glance health board; grouping by **Executor** shows each host's footprint. Select **No grouping** to return to a flat list.

## Tags and groups

Tags and groups are your own labels for organizing the fleet, independent of chain or executor.

* A node can carry **many tags** (for example `prod`, `validator`, `team-payments`).
* A node belongs to **at most one group** (for example `mainnet` or `staging`).

Both are organization-wide vocabularies shared with the [Executors](/docs/executors/overview) list, so a tag you create on a node is immediately available to apply elsewhere.

### Apply or change them

In the **Tags** or **Group** column of a row, click the **+** (or an existing label) to open the picker:

* **Tags** — start typing in **Change or add labels...**. Pick an existing tag, or type a new name and choose **Create new tag:** to make one on the spot. Click a selected tag again to remove it from the node.
* **Group** — open **Set group** (or **Edit group**), then **Pick or create a group...**. Selecting a group replaces any current one; choose **Remove group** to clear it.

To rename or delete a tag or group everywhere it's used, hover it in the picker and use the **pencil** (rename) or **trash** (delete) icon. Renames and deletes apply across every node and executor that carries the label, so treat them as fleet-wide.

Managing tags and groups requires permission to manage organization resources; members without it see the labels read-only.

## Sort

Click any column header to sort by it. Sorting is applied to the rows currently loaded.

## Share or reset a view

Your search, filters, and grouping persist per organization in this browser, so the list looks the same when you come back. The chain, phase, executor, and search choices are also reflected in the page URL — copy it to hand a colleague a ready-made view, or bookmark a combination you return to often. To clear filters, remove each pill with its **X**.