# Groups and tags

## Groups

A group is a labeled collection of Hosts that share a common characteristic, such as a customer, location, or environment. A nested structure helps organize Hosts and simplify navigation. Groups can also define protocol settings inherited by all Hosts in the Group.

{% hint style="info" %}
Groups **are not** folders. On the Hosts screen, you see all hosts in the current groups and their subgroups.
{% endhint %}

### Create a group

1. On the `Hosts` screen, click the chevron next to the `New Host` button and choose `New Group` <br>

   <figure><img src="/files/yDSOJL6SKDegN9wtS5E5" alt=""><figcaption></figcaption></figure>
2. In the `Label` field, enter the group name<br>

   <figure><img src="/files/fGgapCCwelnCjuYZxFqf" alt=""><figcaption></figcaption></figure>
3. To place this group inside another group, fill in the `Parent Group` field<br>

   <figure><img src="/files/XZ93I8umPC5G4IGczq07" alt=""><figcaption></figcaption></figure>
4. Termius auto-saves the group

#### Customize groups

Termius lets you set default parameters for hosts and subgroups within a given group. You can configure default parameters for:&#x20;

* Protocols
* Credentials
* Startup snippets
* Host chaining
* Proxy
* Environment variables
* Terminal themes
* And more

See [How hosts inherit group properties](#how-hosts-inherit-group-properties) for more details.

#### Advanced

You can enable Cloud Sync for a specific group and integrate it with AWS, DigitalOcean, or Azure. Once the setup is completed, Termius syncs the matching instances from that provider. You can create multiple groups for different providers and configurations.

### Move hosts to a group

There are several ways to add or move a host to a group.&#x20;

{% hint style="info" %}
**Important**\
Groups are not folders. Termius shows all hosts within the current group and its subgroups. So, when you move a host to a different group, it may still stay visible on the Hosts screen.
{% endhint %}

{% tabs %}
{% tab title="Edit Host" %}

#### Via edit host

To move hosts to a group via edit host:

1. `Right-click` the host and select `Edit` <br>

   <figure><img src="/files/llXmxvKlXULOSK7Rnc9x" alt=""><figcaption></figcaption></figure>
2. In the `Parent Group` field, select the group<br>

   <figure><img src="/files/sS2tPE4SIjwdxZXxIAx5" alt=""><figcaption></figcaption></figure>
3. Termius auto-saves the changes

#### Via drag'n'drop

To move hosts to a group via drag'n'drop:

1. Select several hosts
2. Drag and drop them onto the group<br>

   <figure><img src="/files/TZ3spREGF8mq1Bx3gUSE" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Mobile" %}
To move several hosts to a group via the context menu:

1. Select several hosts and tap the `three dots` button<br>

   <div align="left"><figure><img src="/files/wYruDtYwiqt8BCNsp6jP" alt="" width="375"><figcaption></figcaption></figure></div>
2. Select `Move to group` <br>

   <div align="left"><figure><img src="/files/92cpui43tIzhLysbl2LH" alt="" width="375"><figcaption></figcaption></figure></div>
3. Select the target group<br>

   <div align="left"><figure><img src="/files/bXb7i2PCdpY9lqsBNXJc" alt="" width="375"><figcaption></figcaption></figure></div>
4. `Save` the changes
   {% endtab %}
   {% endtabs %}

### How hosts inherit group properties

Inheritance in groups is a powerful feature that can significantly simplify host management in Termius.

Every host or subgroup inside a group inherits the properties of that group, unless you override them explicitly.

For example, if you manage a number of production servers and want all of them to have a red terminal theme to stay alert when you interact with them. You can create a group and set the terminal theme accordingly, so every host in the group will have the same theme. When you change the terminal theme in the group, all hosts in it are updated as well.

Another common use case is setting up Host Chaining for a group. When you have several hosts behind the same bastion (or a number of jump hosts), instead of replicating the same configuration on every host, you set this up once in a group. Then every host in that group goes through the specified chain of hosts when you connect to it.

The parameter inheritance works through configuration merging. If the property is not explicitly overridden, Termius checks all parent groups for a default value. This lets you build nested groups with nested inheritance settings on a per-parameter basis to satisfy a wide variety of use cases.&#x20;

### Connect to all hosts inside a group

Another benefit of organizing hosts into groups is the ability to connect to all hosts in a group at once:

1. `Right-click` the group
2. Choose `Quick Connect` from the context menu<br>

   <figure><img src="/files/gNlhNapa0ijW8bFwzEGa" alt=""><figcaption></figcaption></figure>
3. Termius opens a new tab for every host in the group and initiates the connections

{% hint style="info" %}
To connect to multiple hosts at once, you can also use [Workspaces](https://app.gitbook.com/o/VK0PKfeZDvhqkCsvSiAD/s/5PCLq8V6ZExygzYl6XVJ/~/diff/~/changes/159/terminal/workspaces).
{% endhint %}

***

## Tags

Tags give you another way to organize Hosts.

For example, you can tag all Ubuntu servers, servers for a specific client if you are a freelancer, virtual servers, dedicated servers, or hosts with a specific tool installed. Clear tags make large host lists easier to search.

Tags appear on hosts, under host names.

### Create tags

1. `Right-click` the host and choose `Edit` <br>

   <figure><img src="/files/llXmxvKlXULOSK7Rnc9x" alt=""><figcaption></figcaption></figure>
2. In the `Tags` field, type a tag or choose one from the suggestions<br>

   <figure><img src="/files/JGP2pnsgrzwGdngKO1jS" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Removing a tag from a host doesn't delete the tag.
{% endhint %}

### Filter by tags

<figure><img src="/files/3l6TqogDBk8ALCyiRLR1" alt=""><figcaption></figcaption></figure>

When you search for a host on the Hosts screen, the app checks the tags and filters the results accordingly. You can also open the Tags menu and select specific tags to show only hosts that have all selected tags.&#x20;

### Delete tags

1. Open the `Tags` menu

<figure><img src="/files/89grAzllf4tzheIbcPXi" alt=""><figcaption></figcaption></figure>

2. Hover over the tag you no longer need and click the `Delete` button<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.termius.com/organize-and-connect-to-hosts/groups-and-tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
