> For the complete documentation index, see [llms.txt](https://docs.cipp.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cipp.app/user-documentation/identity/administration/groups/add.md).

# Add Group

On this page you will enter all of the necessary information to create a group.

## Basic Group Info

| Field               | Description                                                                                       |
| ------------------- | ------------------------------------------------------------------------------------------------- |
| Display Name        | Set the display name that you want visible for this group                                         |
| Description         | Set the description for the group                                                                 |
| Username            | Set the group's username. This will be used in setting the mail nickname, e-mail address, etc.    |
| Primary Domain Name | Select the domain from the dropdown that you wish to set as the primary domain name for the group |
| Owners              | Select one or more owners of the group from the dropdown                                          |
| Members             | Select one or more members of the group from the dropdown                                         |

## Group Types

| Type                        | Additional Settings                                                                                                                                                        |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Azure Role Group            | None                                                                                                                                                                       |
| Security Group              | Licenses - You can select the licenses assigned to the group. Note that to be compliant with Microsoft licensing, the tenant should be licensed for Entra ID P1 or higher. |
| Microsoft 365 Group         | None                                                                                                                                                                       |
| Dynamic Group               | Dynamic Group Parameters (see below)                                                                                                                                       |
| Dynamic Distribution Group  | Dynamic Group Parameters (see below)                                                                                                                                       |
| Distribution List           | Let people outside the organization email the group - Allows the group to receive messages from both inside and outside the organization.                                  |
| Mail Enabled Security Group | None                                                                                                                                                                       |

### Dynamic Group Parameters

For Dynamic Groups, a text box for entering the dynamic group parameters syntax becomes available e.g.: `(user.userPrincipalName -notContains "#EXT#@") -and (user.userType -ne "Guest")`.

***

## Feature Requests / Ideas

We value your feedback and ideas. Please raise any [feature requests](https://github.com/CyberDrain/CIPP/issues/new?template=feature.yml) on GitHub.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.cipp.app/user-documentation/identity/administration/groups/add.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.