---
url: https://docs.corbitaltech.dev/products/whatsmark-saas/tenant/groups.md
---

# Group Management

WhatsMark SaaS provides a powerful **Group Management** system to help you organize, segment, and manage contacts more efficiently. With this feature, you can create groups, assign contacts to those groups, and filter or operate on contacts based on their group association.

## Key Features

* Create and manage custom groups
* Assign contacts to one or more groups
* Filter contacts by group
* Edit and delete groups
* Improve targeting for messaging and marketing

## Creating a New Group

To create a group:

1. Go to the **Setup**.
2. Click on **Groups** in the sidebar.
3. Click on the **"+ New Group"** button.
4. A modal will appear asking for the group name.

### Group Creation Modal

* **Name**: This is a required field. Provide a meaningful group name (e.g., `whatsapp-group`, `facebook-leads`, `referrals`).
* Click **Submit** to save the group.
* Click **Cancel** to discard.

> Duplicate group names may not be allowed depending on the implementation.

***

![Create Group](../images/groups/group-create.png)

## Viewing and Managing Existing Groups

Once created, groups will be listed in a table view showing the following:

* **Serial Number**
* **Group Name**
* **Actions** (Edit / Delete)

### Example Group List

![Group List](../images/groups/group-list.png)

You can:

* **Edit**: Update the name of the group.
* **Delete**: Remove the group from the system.

> Deleting a group may affect associated contacts depending on the business rules.

## Assigning Groups to Contacts

Groups become meaningful when contacts are associated with them. You can assign a group when:

### Creating a New Contact

1. Go to **Contacts > New Contact**.
2. Fill in the contact information.
3. In the **Assign to Group** dropdown, select the desired group(s).
4. Click **Save**.

![Group Assign](../images/groups/assign-group.png)

### Editing an Existing Contact

1. Go to **Contacts**.
2. Click **Edit** down to the contact name.
3. Update the group assignment.
4. Save changes.

![Group Assign](../images/groups/edit-contact.png)

## Filtering and Managing Contacts by Group

To work with contacts in a specific group:

1. Navigate to **Contacts**.
2. Use the **Group Filter** dropdown or search bar.
3. Select the desired group.
4. The list will now display only the contacts belonging to that group.

### Common Use Cases

* Send bulk messages to a group
* Export group contacts
* Segment leads, clients, or referrals
* Apply bulk actions to a group (tagging, status update, etc.)

## Real-World Example: Using Groups Effectively

Imagine you're running a marketing campaign for WhatsApp users:

1. Create a group called `whatsapp-group`.
2. Add all WhatsApp leads or customers to this group.
3. Filter the group from the Contacts page.
4. Send a targeted message or offer to all members of the group.

## Best Practices

| Recommendation       | Description                                                        |
| -------------------- | ------------------------------------------------------------------ |
| Use clear names      | E.g., `leads-august`, `newsletter-subscribers`, `referral-program` |
| Keep names lowercase | Improves consistency                                               |
| Clean unused groups  | Periodically review and delete groups not in use                   |
| Avoid duplicates     | Prevent confusion and errors during automation                     |
| Segment meaningfully | Use groups to drive campaign logic and targeting                   |

## Benefits of Group Management

* Organized contact database
* Easier segmentation for marketing and messaging
* Improved personalization
* Better data hygiene and performance
* Save time and reduce manual errors