Groups

Groups

Groups let you organize your connections into folders in the sidebar. Groups can be nested to create a hierarchy, colored for visual clarity, and reordered by drag and drop.

---

Creating a Group

1. Click the New Group button in the sidebar header
2. Type a name
3. Optionally pick a color
4. Click Create

The new group appears at the bottom of the sidebar.

---

Adding Connections to a Group

Drag and drop:

• Drag a connection from the sidebar onto a group header
• The group highlights to show it is a valid drop target

Right-click:

• Right-click a connection
• Select Move to Group and choose the group

Edit dialog:

• Open a connection's edit dialog
• Set the Group field

---

Nested Groups (Subgroups)

Groups can contain other groups, creating a tree structure.

Creating a subgroup

1. Drag a group header onto another group header
2. The dragged group becomes a subgroup of the target

You can also drag a group into a gap inside another group's tree (see Drag and Drop below).

Ungrouping a subgroup

• Right-click the subgroup header
• Select Ungroup
• The subgroup moves to the top level

Dragging a subgroup to the sidebar root also ungroups it.

---

Group Colors

Every group can have its own color. Colors help you visually distinguish groups at a glance.

Setting a color

1. Right-click the group header
2. Select Edit Group
3. Click the color button and pick a color
4. Click Save

Color display modes

Choose how group colors appear in the sidebar. Go to Settings > Groups > Group Appearance > Sidebar Group Colors:

Mode	Description
Colored Rows	The entire group header row gets a colored background
Color Badges	A small colored badge appears next to the group name
Accent Bars	A thin colored bar appears on the left edge of the row
Color Dots	A small colored dot appears next to the group name

Color settings

In Settings > Groups > Group Appearance:

Setting	Description
Use Group Color for Child Rows	Apply the group's color to its connections and subgroups
Show Group Color in Tabs	Show the group's color badge in terminal tabs
Use Group Color in Terminals	Use the group's color as the terminal background

---

Group Layout

Choose how grouped connections appear in the sidebar. Go to Settings > Groups > Group Layout:

Mode	Description
Fullwidth	Group header spans full width; only the content is indented
Nested	The entire group header card shifts right to show nesting

---

Drag and Drop

You can reorder groups and move connections between them by dragging.

What you can drag

Dragging	Drops onto	Result
Connection	Group header	Connection moves to that group
Connection	Between groups	Connection is placed at that position (ungrouped)
Group header	Between groups	Group is reordered
Group header	Another group	Group becomes a subgroup

Rules

• You cannot drop a group onto itself or one of its descendants
• Tag groups (virtual groups from tags) cannot be dragged or reordered
• Dragging a subgroup to the sidebar root ungroups it

---

Right-Click Menu

Right-click a group header for these actions:

• Edit Group -- change name and color
• Open in Split View -- open all connections in a split view
• Run Command -- execute a command on all connections in the group
• Ungroup -- move to the top level (nested groups only)
• Delete Group -- remove the group (connections are kept, just ungrouped)

---

Middle-Click

• Middle-click a group -- opens all connections in that group, each in a new tab

---

Tips

• Colors propagate: Turn on "Use Group Color for Child Rows" to color an entire branch of your hierarchy with one color
• Quick access: Middle-click a group to open all its servers at once
• Nesting limit: There is no limit to nesting depth, but 2-3 levels is usually enough