> ## Documentation Index
> Fetch the complete documentation index at: https://www.integrate.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ETL: Organize Connections with Connection Groups

> Organize Integrate.io ETL connections into named groups to scope browsing, separate environments, and manage connections by team or project.

Connection groups let you organize related connections under a single named group. Use them to separate connections by team, environment, project, or any other grouping that matches how you work.

A connection can belong to one group at a time. Connections that are not assigned to a group remain available from the main **Connections** list as before.

## When to use connection groups

* You manage many connections and want to scope what you see while browsing.
* Multiple teams or projects share an account and each owns a distinct set of connections.
* You want to separate connections by environment, such as production and staging.

## Create a connection group

<Steps>
  <Step>
    Click the **Connections** icon on the main left menu, then open **Groups**.
  </Step>

  <Step>
    Click **New connection group**.
  </Step>

  <Step>
    Enter a name and an optional description for the group.
  </Step>

  <Step>
    Add connections to the group using the connection picker. Connections already assigned to another group are not shown.
  </Step>

  <Step>
    Click **Create connection group**.
  </Step>
</Steps>

## Edit or delete a group

From the **Groups** list, use the actions on a group to:

* **Edit** — change the group name, description, or membership.
* **Duplicate** — create a new group with the same settings.
* **Delete** — remove the group. The connections themselves are not deleted; they return to the ungrouped state.

## Move a connection between groups

Open a connection and update its group from the connection form, or edit the target group and add the connection from the picker. Removing a connection from a group does not delete the connection.

## Search and filter

The **Groups** list supports assisted search by group attributes. When you open a group, the connections view is scoped to that group and supports the same search and filter options as the main connections list.

## Restrict a Package Group to specific connection groups

Account admins can bind a [package group](/docs/etl/package-groups) to one or more connection groups so its packages may only reference connections from those groups. Once bound, the connection picker, save-time validation, and job run-time all enforce the restriction. See [Restricting a Package Group to specific Connection Groups](/docs/etl/package-groups#restricting-a-package-group-to-specific-connection-groups) for the API and the rules.