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

# Managing contact groups

The **Contact groups** page of Organisation Administration ([below](/CS1.2/admin-org/managing-contact-groups.md#contact-groups-page)) allows the following within an organisation:

* The [addition of new contact groups](/CS1.2/admin-org/managing-contact-groups.md#adding-a-new-contact-group).
* Existing contact groups to be [edited](/CS1.2/admin-org/managing-contact-groups.md#editing-an-existing-contact-group) or [removed](/CS1.2/admin-org/managing-contact-groups.md#removing-an-existing-contact-group).

Organisation administrators can create and modify *contact groups*, each of which is a group of Cocoon Data users (with the [Originator role](/CS1.2/admin-org/administering-users-within-an-organisation.md#originator-role)) with whom items can be shared. This avoids the need for a Cocoon Data user to specify each email address of a group of users each time they need to share an item with that group of users.

![Contact groups page](https://mintcdn.com/cocoondata/XFCH1-fsOPTworsw/images/a36912daf28a-contact-groups-page.png?fit=max\&auto=format\&n=XFCH1-fsOPTworsw\&q=85\&s=d68c5904266f4782cd7476f9a61dcb79)

## Adding a new contact group

1. Ensure you are [signed in](/CS1.2/admin-org/accessing-organisation-administration.md#signing-in-to-organisation-administration) to Organisation Administration.
2. Click the **Contact groups** option on the left of the [Organisation Administration interface](/CS1.2/admin-org/accessing-organisation-administration.md#the-organisation-administration-interface) to open the **Contact groups** page.
3. Click the **Create** button.
4. In the **New contact group** dialog box, specify the:

   * **Name** - A name that best describes the contact group's members. This is the name of the contact group that Cocoon Data users would specify when sharing an item with this contact group.
   * **Description ( *Optional* )** - A longer description to provide more information about the contact group.
   * **Manage contacts** - In this section, any Cocoon Data users (with the [Originator role](/CS1.2/admin-org/administering-users-within-an-organisation.md#originator-role)) whose email addresses appear in the **Selected users** section on the right will be members of the contact group:

     | To do the following: | Do this: | Which results in this: |
     | - | - | - |
     | Add a user to the contact group | Click the email address of that user in the **Available users** section. | Transfers that user to the **Selected users** section. |
     | Remove a user from the contact group | Click the email address of that user in the **Selected users** section. | Transfers that user to the **Available users** section. |
     | Find specific users by filtering them (making it easier to add or remove them above) | In either the **Available users** or **Selected users** sections, begin typing (into its respective **Filter** box) a series of characters contained in the Cocoon Data users' email addresses. | The list of users (in their respective section/s) being filtered to those whose email address contains the subset of characters entered into its **Filter** box. |
     | Add all users to the contact group | Click the  ![Add all button](https://mintcdn.com/cocoondata/XFCH1-fsOPTworsw/images/ba0414469515-add-all.png?fit=max\&auto=format\&n=XFCH1-fsOPTworsw\&q=85\&s=9eca0d8f47f065e9d35c3221ff11b7ce)   (Add all) button in the **Available users** section. | Transfers all remaining users in this section to **Selected users**. |
     | Remove all users from the contact group | Click the  ![Remove all button](https://mintcdn.com/cocoondata/_MzKWwAlmVvZNHNz/images/ceb2b8442518-remove-all.png?fit=max\&auto=format\&n=_MzKWwAlmVvZNHNz\&q=85\&s=41fb2069a92f162ec4b1d42f56de23a9)   (Remove all) button in the **Selected users** section. | Transfers all remaining users in this section to **Available users**. |

## Editing an existing contact group

1. Ensure you are [signed in](/CS1.2/admin-org/accessing-organisation-administration.md#signing-in-to-organisation-administration) to Organisation Administration.
2. Click the **Contact groups** option on the left of the [Organisation Administration interface](/CS1.2/admin-org/accessing-organisation-administration.md#the-organisation-administration-interface) to open the **Contact groups** page.
3. Locate/scroll to the relevant contact group and click its row.
4. Click the **Edit** button.
5. In the **Edit contact group** dialog box, modify the:

   * **Name** - A name that best describes the contact group's members. This is the name of the contact group that Cocoon Data users would specify when sharing an item with this contact group.
   * **Description ( *Optional* )** - A longer description to provide more information about the contact group.
   * **Manage contacts** - In this section, any Cocoon Data users (with the [Originator role](/CS1.2/admin-org/administering-users-within-an-organisation.md#originator-role)) whose email addresses appear in the **Selected users** section on the right will be members of the contact group:

     | To do the following: | Do this: | Which results in this: |
     | - | - | - |
     | Add a user to the contact group | Click the email address of that user in the **Available users** section. | Transfers that user to the **Selected users** section. |
     | Remove a user from the contact group | Click the email address of that user in the **Selected users** section. | Transfers that user to the **Available users** section. |
     | Find specific users by filtering them (making it easier to add or remove them above) | In either the **Available users** or **Selected users** sections, begin typing (into its respective **Filter** box) a series of characters contained in the Cocoon Data users' email addresses. | The list of users (in their respective section/s) being filtered to those whose email address contains the subset of characters entered into its **Filter** box. |
     | Add all users to the contact group | Click the  ![Add all button](https://mintcdn.com/cocoondata/XFCH1-fsOPTworsw/images/ba0414469515-add-all.png?fit=max\&auto=format\&n=XFCH1-fsOPTworsw\&q=85\&s=9eca0d8f47f065e9d35c3221ff11b7ce)   (Add all) button in the **Available users** section. | Transfers all remaining users in this section to **Selected users**. |
     | Remove all users from the contact group | Click the  ![Remove all button](https://mintcdn.com/cocoondata/_MzKWwAlmVvZNHNz/images/ceb2b8442518-remove-all.png?fit=max\&auto=format\&n=_MzKWwAlmVvZNHNz\&q=85\&s=41fb2069a92f162ec4b1d42f56de23a9)   (Remove all) button in the **Selected users** section. | Transfers all remaining users in this section to **Available users**. |

## Removing an existing contact group

1. Ensure you are [signed in](/CS1.2/admin-org/accessing-organisation-administration.md#signing-in-to-organisation-administration) to Organisation Administration.
2. Click the **Contact groups** option on the left of the [Organisation Administration interface](/CS1.2/admin-org/accessing-organisation-administration.md#the-organisation-administration-interface) to open the **Contact groups** page.
3. Locate/scroll to the relevant contact group and click its row.
4. Click the **Remove** button.
5. On the **Remove contact group** message box, click **Yes** to proceed with the contact group's removal.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.