# Groups

Groups organize your environments in Portainer. As an example, you can create groups for development, staging and production to differentiate between environment roles. You can also use groups to define which environments are available to which users.

{% hint style="info" %}
Portainer Community Edition supports basic user and group assignments. For more complex user roles within groups, use Portainer Business Edition.
{% endhint %}

## Adding a group

From the menu expand **Environment-related**, select **Groups**, then click **Add group**.&#x20;

<figure><img src="/files/5pR6tWYAO57TIeNsd1iR" alt=""><figcaption></figcaption></figure>

Define the properties of the group, using the table below as a guide.

| Field/Option            | Overview                                                |
| ----------------------- | ------------------------------------------------------- |
| Name                    | Give the group a descriptive name.                      |
| Description             | Optionally describe the group in more detail.           |
| Tags                    | Apply any tags to the group.                            |
| Associated environments | Select the environments to be categorized in the group. |

<figure><img src="/files/6dwgd2ngYWn3t0u8HYvf" alt=""><figcaption></figcaption></figure>

When you're finished, click **Create the group**.

## Removing a group

When you no longer need a group, you can remove it by ticking the box next to the group then clicking **Remove**.

{% hint style="info" %}
Removing a group will not delete environments and users in that group. However, it may change the environments accessible to users who have their access assigned via a group.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.portainer.io/2.33-lts/admin/environments/groups.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
