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).

Creating a Group

1. Open your workspace and go to Settings → Groups.
2. Click New 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. A domain can belong to only one group at a time.

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

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 domains appear in on the main dashboard.

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 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

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
• None - flat list

Switch between modes from the dashboard's Customize menu - see Dashboard Customization.

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 1-2 words works best.

Related