All Tutorials

Monitor Groups & Drag-and-Drop

Monitor Groups let you organize your uptime monitors into logical categories — such as "API Services", "Frontend", or "Infrastructure" — so your dashboard and public status page stay clean and readable as you scale.

Why Use Groups?

• Organization — Keep related monitors together (e.g. all API endpoints, all marketing pages).
• Status at a glance — Each group shows a computed status badge (Operational, Degraded, Partial Outage, Major Outage) based on its child monitors.
• Collapsible on status page — Visitors can expand or collapse groups to focus on what matters.
• Drag-and-drop — Reorder monitors within a group, drag monitors between groups, or reorder the groups themselves.

Creating a Group

1. Navigate to Uptime Monitor in the sidebar.
2. Click the "New Group" button at the top of the monitor list.
3. Enter a name (e.g. "API Services") and an optional description.
4. Click Save. The group appears immediately in your monitor list.

Editing or Deleting a Group

• Click the pencil icon on any group header to edit its name and description.
• Click the trash icon to delete the group. You will be asked to confirm. Deleting a group does not delete its monitors — they become ungrouped.

Adding Monitors to a Group

There are two ways to assign a monitor to a group:

1. Drag-and-drop — Simply drag a monitor from the "Ungrouped" section (or from another group) and drop it into the target group.
2. Edit form — When adding or editing a monitor, select a group from the "Monitor Group" dropdown.

Drag-and-Drop Reordering

The monitor list and status page editor both support drag-and-drop:

Action	How
Reorder within a group	Drag a monitor by its handle (☰) and drop it at the desired position within the same group.
Move to another group	Drag the monitor and drop it into a different group's list. The monitor is automatically reassigned.
Ungroup a monitor	Drag a monitor from any group and drop it into the "Ungrouped Monitors" section at the bottom.
Reorder groups	In the Status Page Editor, groups are displayed in their display order. Use the API or admin panel to reorder groups.

Changes are saved automatically — there's no need to click a save button after reordering.

Group Status Badges

Each group displays a computed status badge based on the aggregate status of its monitors:

Badge	Meaning	Condition
🟢 Operational	All monitors are up	Every monitor in the group is responding normally.
🟡 Degraded	Performance issues	At least one manual monitor has a "degraded" status.
🟠 Partial Outage	Some monitors are down	A mix of up and down monitors in the group.
🔴 Major Outage	All monitors are down	Every monitor in the group is failing.
🔵 Maintenance	Under maintenance	At least one manual monitor is in "maintenance" mode.
⚪ Unknown	No active monitors	The group is empty or all monitors are paused.

Groups on the Public Status Page

When you create groups, your public status page automatically organizes monitors under their group headings:

• Each group shows its name, optional description, and computed status badge.
• Groups can be collapsed by default — enable this in the group settings if you want visitors to see a compact view.
• You can hide a group from the status page by toggling its "Show on status page" setting in the Status Page Editor.
• Monitors not assigned to any group appear under an "Other Monitors" section.

Groups in the Status Page Editor

The Status Page Editor shows all your groups and monitors with drag-and-drop support:

1. Navigate to Status Page in the sidebar.
2. In the "Monitor Visibility & Groups" section, you'll see your groups with their monitors.
3. Toggle the eye icon to show or hide individual monitors on the public page.
4. Toggle the eye icon next to a group name to show or hide the entire group.
5. Drag monitors between groups to reorganize.
6. Click "New Group" to create additional groups.

API Reference

Monitor groups are fully manageable via the REST API. All endpoints require authentication.

Method	Endpoint	Description
GET	/uptime/api/groups/	List all your monitor groups.
POST	/uptime/api/groups/	Create a new group.
GET	/uptime/api/groups/{id}/	Get a single group.
PUT/PATCH	/uptime/api/groups/{id}/	Update a group's name, description, or settings.
DELETE	/uptime/api/groups/{id}/	Delete a group (monitors become ungrouped).
POST	/uptime/api/groups/reorder/	Bulk-update display order of groups.

The link reorder endpoint (POST /uptime/api/links/reorder/) now also supports an optional group field to move monitors between groups:

{
  "order": [
    {"id": 100, "display_order": 0, "group": 5},
    {"id": 101, "display_order": 1, "group": null}
  ]
}