# Domain Groups



When a workspace contains many domains, custom **domain groups** let you organize them visually on the dashboard. You can group by client, environment (staging vs production), team, or any other dimension that makes sense for your work.

Groups live at **Workspace Settings → Groups** (`/dashboard/workspace/{workspaceId}/settings/groups`).

<Callout type="info">
  Domain groups are personal to your dashboard view. Each team member sets up their own groups; the ones you create here aren't shared with the rest of the workspace.
</Callout>

## Creating a Group [#creating-a-group]

1. Open your workspace and go to **Settings → Groups**.
2. Click **Add group**.
3. Give the group a name.
4. Pick a color from the palette - the color appears next to the group's domains on the dashboard.
5. Add domains to the group (see below).

You can create as many groups as you need.

## Adding & Removing Domains [#adding--removing-domains]

Inside a group:

* Click the picker to add any domain that isn't yet assigned to this group.
* Click the **X** next to a domain to remove it from the group (the domain itself isn't deleted, just removed from the group).

Domains that aren't in any group still show up on the dashboard - they appear in an **Ungrouped** section.

## Reordering Domains in a Group [#reordering-domains-in-a-group]

Each group supports drag-and-drop reordering:

1. Hover over a domain in the group.
2. Grab the handle on the left.
3. Drag it to the desired position.

The order you set here is the order in which domains appear on the main dashboard.

## Renaming or Recoloring a Group [#renaming-or-recoloring-a-group]

* Click the group name to rename it inline.
* Click the color swatch to open the picker and choose a new color.

Changes save immediately.

## Deleting a Group [#deleting-a-group]

Deleting a group does **not** delete the domains inside it - they simply move back to **Ungrouped**. To delete a group, click its delete control and confirm.

## How Groups Show Up on the Dashboard [#how-groups-show-up-on-the-dashboard]

The main dashboard (`/dashboard`) lets you choose how to organize the domain list:

* **By workspace** - the default, showing each workspace as its own section
* **By custom groups** - uses the groups you've defined here

Switch between modes from the dashboard's **Customize** menu - see [Dashboard Customization](/features/dashboard-customization).

## Tips [#tips]

* **Match groups to how you scan the dashboard.** Agencies typically group by client; product teams group by environment or service.
* **Use color sparingly.** A few high-contrast colors (e.g. red for production, gray for staging) read faster than ten different shades.
* **Keep group names short.** They render inline on the dashboard, so one or two words work best.

## Related [#related]

<Cards>
  <Card title="Managing Workspaces" href="/workspace/managing-workspaces">
    Organize domains, billing, and team
  </Card>

  <Card title="Dashboard Customization" href="/features/dashboard-customization">
    Time ranges, modules, and grouping modes
  </Card>
</Cards>