> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Edit a virtual cluster

Gateway Manager 1.2.3+

You can edit a virtual cluster to update its name, description, distribution type, or cluster membership. Changes take effect for new jobs immediately after saving. In-flight jobs complete under the prior configuration.

## Open the edit form

1. Navigate to **Gateway Manager**.
2. Select the virtual cluster you want to edit from the cluster table.
3. In the detail panel, select **Edit Cluster**.

The edit form uses the same layout as the create form. The live preview on the right updates as you make changes.

## Edit cluster details

To update the **Cluster ID** or **Description**, edit the fields directly and select **Save**.

## Change the distribution type

To convert a virtual cluster between Active/Standby and Load Balancing, select a new value in the **Distribution** dropdown. The preview panel updates immediately to reflect the new type—**Failover Chain (Preview)** for Active/Standby, **Cluster Pool (Preview)** for Load Balancing.

**Converting from Active/Standby to Load Balancing:** The primary and backup designations are preserved in the member list, but all reachable members begin serving traffic simultaneously once the change is saved. In-flight jobs on the current active cluster complete normally.

**Converting from Load Balancing to Active/Standby:** The current primary cluster remains the primary. Backup clusters retain their existing order. Once saved, only the primary serves new traffic; other members stand by.

The virtual cluster's Cluster ID is unchanged by a type conversion. Platform features that reference the cluster by name require no reconfiguration.

## Add or remove member clusters

**To add a cluster:**

1. Select **Add Backup Cluster** and choose a physical cluster from the dropdown.
2. For active/standby clusters, drag the new entry to the correct position in the failover order.
3. Select **Save**.

When you add a cluster to a virtual cluster that is already enabled, all users with access to the virtual cluster immediately gain implicit runtime access to the newly added cluster and its services. Verify that the cluster and its services are appropriate for all user groups assigned to this virtual cluster before saving.

**To remove a cluster:**

1. Select the delete icon next to the cluster you want to remove.
2. Select **Save**.

Removing a cluster from a live virtual cluster immediately stops new jobs from routing to it. In-flight jobs on that cluster complete normally.

**To reorder backup clusters (active/standby only):**

1. Drag clusters to the desired position in the list. The topmost backup is the first failover target.
2. Select **Save**.

## Cancel changes

Select **Cancel** to discard all unsaved changes and return to the detail view. No changes are applied.

## Related topics

* [Virtual clusters overview](./overview)
* [Create a virtual cluster](./create-virtual-cluster)
* [Monitor virtual cluster status](./monitor-virtual-cluster-status)
* [RBAC in Gateway Manager](../rbac-gateway-manager)