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

# Groups & Billing Groups

<Info>
  Applicable plans: Enterprise
</Info>

Groups and Billing Groups solve two different problems: Groups manage functional authorization groupings for members, while Billing Groups manage Credits consumption attribution, period usage limits, and exports.

If you only want to put members together for future functional authorization, use Groups. If you need to confirm Credits consumption attribution, control team usage, or export period records, use Billing Groups.

## **Core Concepts**

| **Concept**   | **Purpose**                                          | **Member Relationship**                                  | **Affects Credits Attribution** | **Supports Group-Level Limit** |
| :------------ | :--------------------------------------------------- | :------------------------------------------------------- | :------------------------------ | :----------------------------- |
| Group         | Functional authorization grouping                    | A member can join multiple groups                        | No                              | No                             |
| Billing Group | Credits attribution, group-level limits, and exports | A member can belong to at most one billing group         | Yes                             | Yes                            |
| `Unassigned`  | System built-in unassigned billing group             | Holds members not explicitly assigned to a billing group | Yes                             | No                             |

> Note: `Unassigned` is a system group name and is not translated. It cannot be renamed, deleted, or have a period usage limit set.

## **Managing Groups**

Groups only manage member relationships — they do not change member accounts, roles, seats, personal usage limits, or billing groups.

### **Creating a Group**

1. Open the Groups page in Member Management.
2. Click **Create**.
3. Enter a **Name** and optionally a **Description**.
4. Click **Create**.

Group names cannot be empty. Using project, team, or authorization scenario names is recommended for clarity.

### **Maintaining Group Members**

In group details, admins can add members, remove members, edit the group, or delete the group.

* Adding a member does not change their role, billing group, or personal usage limit.
* Removing a member only deletes the group relationship — it does not remove the organization member.
* Deleting a group only deletes the group and its member relationships — it does not affect member accounts, billing groups, or historical usage.
* Groups are not used for Credits attribution and cannot have Credits limits set.

## **Managing Billing Groups**

Billing Groups determine the Credits consumption attribution for members. A member can belong to at most one billing group at any given time.

### **Creating a Billing Group**

1. Open the Billing Groups page in Member Management.
2. Confirm the current period is selected.
3. Click **Create**.
4. Enter a **Name** and optionally a **Description**.
5. Click **Create**.

Billing group descriptions are only used to explain cost centers, teams, or usage scope — they do not participate in attribution rules or limit calculations.

### **Assigning Members**

Admins can assign billing groups from the member list, member details, or the Billing Groups page.

* Members not explicitly assigned to a billing group enter `Unassigned`.
* From the `Unassigned` row, select **Handle** to assign members to a formal billing group.
* Reassigning a member only changes the current billing group; historical usage from previous periods remains in the original period records.
* After deleting a formal billing group, current members return to `Unassigned`; historical usage and export records are preserved.

### **Setting Period Usage Limits**

Billing group period usage limits control the total Credits consumption for that billing group within the current period.

1. Select **Set Period Limit** from the billing group's action menu.
2. Enter the **Period Usage Limit** in Credits.
3. Click **Save**.

When not configured, no group-level limit is enforced — members are still subject to personal usage limits and other configured restrictions. `Unassigned` does not support period usage limits.

### **Viewing Members and Usage**

Open billing group details to view current members, current period usage, and user records that generated Credits consumption during the selected period.

The current period shows current members and usage records. Historical periods only show usage records, as current member relationships may not represent the membership at the end of a historical period.

## **Usage Limits**

Qoder uses Credits as the usage unit. Pages, detail drawers, export previews, and CSVs only display Credits — no monetary conversion or estimated amounts are shown.

| **Limit**                        | **Effect**                                                                     | **When Not Configured**               |
| :------------------------------- | :----------------------------------------------------------------------------- | :------------------------------------ |
| Personal usage limit             | Controls Credits a single member can use in the current period                 | Member temporarily cannot use Credits |
| Billing group period usage limit | Controls total Credits consumption for the billing group in the current period | No group-level restriction            |

Members must have a personal usage limit greater than 0 to use Credits. When personal usage reaches the personal limit, or when the billing group reaches the period usage limit, the member is temporarily unable to continue using Credits.

When the period switches, consumed Credits reset to 0; limit configurations are preserved unless the admin modifies them.

## **Exporting Billing Group Bills**

Admins can export billing group Credits consumption records for the selected period. Export supports all billing groups or a single billing group.

Export fields include:

| **Field**           | **Description**                                                                             |
| :------------------ | :------------------------------------------------------------------------------------------ |
| Billing Group       | Billing group name, including `Unassigned`                                                  |
| Member Name         | Member's name                                                                               |
| Email               | Member's email                                                                              |
| Credits Consumption | Credits consumed by this member attributed to this billing group during the selected period |

Export results do not include period, role, seat assignment, billing group attribution time, monetary conversion, or estimated amounts. The period is already selected before export and is not repeated as a CSV column.

## **Historical Periods**

Historical periods are only for viewing and exporting records. They do not support creating billing groups, assigning members, handling `Unassigned`, setting period usage limits, editing billing groups, or deleting billing groups.

## **FAQ**

### **Can a member join multiple groups?**

Yes. Groups have a many-to-many relationship.

### **Can a member belong to multiple billing groups?**

No. Billing groups are used for Credits attribution — a single member can belong to at most one billing group at any given time.

### **Does deleting a group delete members?**

No. Deleting a group only deletes the group and its member relationships.

### **Does deleting a billing group delete members?**

No. After deleting a formal billing group, current members return to `Unassigned`; historical usage and export records are preserved.

### **Are members in `Unassigned` included in exports?**

Yes. Exporting all billing groups includes `Unassigned`. Exporting a single `Unassigned` includes only records attributed to `Unassigned` during the selected period.
