# Groups

The Groups Settings page controls which Entra ID groups Bsure tracks in detail. By default Bsure collects every named group in your tenant, but only the groups you add here have their **members** resolved and their **cost** allocated. Use it to map costs onto the groups that drive licensing, applications, or business-unit chargeback.

It is designed to answer simple but important questions:

* Which Entra ID groups should we track in Bsure?
* What does membership in each group cost the organisation per month?
* Why are we tracking it — what report is it feeding?

***

### Accessing Groups Settings

Navigate to **Settings → Configuration** in the left sidebar, then select **Groups**. You can also access it directly via the URL path */admin-settings/groups*.

### Page Layout

The Groups Settings page consists of the following elements:

<figure><img src="/files/WlqjALZ6AJfLVmLUbD2M" alt=""><figcaption></figcaption></figure>

#### Action Buttons

At the top-right corner of the page, you will find:

* **Collect Group Members** – Click this to refresh group membership data across the groups in the table and refresh the Power BI Groups report. Use this after adding or removing groups.
* **Add Groups** – Click to add a group from your Entra ID tenant to the list. A dialog opens where you search and pick the group, then enter cost and description.

#### Table Toolbar

Above the group list, a toolbar provides:

* **Row count** – Total number of groups currently configured for tracking.
* **Reset Filters** – Clears any active filters applied to the table columns.
* **Columns** – Show or hide specific columns to customise your view.
* **Export** – Exports the current group list for offline use or further analysis.

#### Group Table

The main content area shows a table listing the tracked groups with the following columns:

| Column                | Description                                                                                                            |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Group Name**        | The name of the Entra ID group. Includes a text filter for searching.                                                  |
| **Monthly User Cost** | The per-member monthly cost you have assigned to the group, used in cost allocation reporting.                         |
| **Usage Description** | A short description explaining why this group is tracked (e.g. *Visma access*, *Secure-zone*). Includes a text filter. |

Each column header supports sorting. The Group Name and Usage Description columns also support text filtering.

### Adding a group

{% stepper %}
{% step %}

### Open Groups Settings

Navigate to **Settings → Configuration → Groups** in the left sidebar.
{% endstep %}

{% step %}

### Start adding a group

Click **Add Groups** in the top-right corner.
{% endstep %}

{% step %}

### Search and select the group

Search for the group by name and click the group you want.
{% endstep %}

{% step %}

### Continue to the next screen

Click **Next**.
{% endstep %}

{% step %}

### Fill in the group details

* **Monthly User Cost** – the cost per member, in your chosen currency.
* **Usage Description** – a short description of why you're tracking this group.
  {% endstep %}

{% step %}

### Save the group

Click **Add New Group** to save.
{% endstep %}

{% step %}

### Add any additional groups

Repeat for any additional groups you want to track.
{% endstep %}
{% endstepper %}

### Editing or removing a group

To edit or remove an existing entry, click the **three-dot menu (⋮)** at the right end of the row.

### Refreshing Group Members and reports

Once you have added or changed groups, click **Collect Group Members** at the top-right of the page. Bsure refreshes membership data and updates the Power BI Groups report. The collection takes a few minutes; you can follow progress by clicking the bell icon next to your name in the top-right corner of the app.

### Filtering, sorting, exporting

The group table provides several ways to find and organise your data:

* **Column sorting** – Click any column header to sort. Click again to reverse the sort order.
* **Text filters** – The Group Name and Usage Description columns have filter input fields below the header.
* **Reset Filters** – Clears all active filters.
* **Column visibility** – Use the Columns dropdown to show or hide specific columns.
* **Export** – Download the current group list, with the active filters and sorting applied.

### Summary

Use Groups Settings to tell Bsure which Entra ID groups to resolve members for, and to attach a per-member cost so cost-allocation reports work without spreadsheets. Add the groups you care about, set the cost, then collect members and refresh.

### Next steps

1. Add the groups you want to track for membership or cost allocation.
2. Set a Monthly User Cost on each one if you do cost allocation.
3. Add a clear Usage Description so the group's purpose is obvious to the next admin.
4. Click **Collect Group Members** and verify the updated Groups report.


---

# 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.bsure.io/user-guides/settings/configuration/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.
