> For the complete documentation index, see [llms.txt](https://docs.qolaba.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qolaba.ai/organization-and-workspaces/workspaces/workspace-credit-allocation.md).

# Workspace Credit Allocation

Understand how credit allocation works across Workspaces using shared pools or individual workspace budgets.

Workspace Credit Allocation defines how credits are distributed across workspaces. It allows organizations to either use a shared credit pool or assign fixed budgets to individual workspaces, enabling controlled and transparent usage.

{% embed url="<https://youtu.be/r6NShDw7Nls?si=wEBv0NmPeYNlex0D>" %}

***

### Credit Modes

You can switch between modes from the dropdown at the top of the **Workspaces** tab.

#### 1. Shared Pool Mode

All workspaces consume credits from a single shared pool.

* Credits reside in the **Primary Workspace**
* No per-workspace limits are enforced
* All usage deducts from the same central balance

**When to use:**\
Suitable for smaller teams or when centralized control is sufficient.

#### 2. Workspace Budget Mode

Each workspace operates within an assigned credit limit.

* Credits are distributed to individual workspaces
* Usage is restricted to the allocated budget
* Additional credits must be assigned when required

**When to use:**\
Recommended for managing multiple teams, clients, or projects with defined budgets.

***

### Primary Workspace

The **Primary Workspace** acts as the default credit source.

* All purchased or added credits are stored here
* Its balance updates dynamically based on allocations

**Example:**\
If total credits = 10,000

* 2,000 allocated to Workspace A
* 3,000 allocated to Workspace B

Primary Workspace balance = **5,000**

***

### Allocating Credits

Credits can be transferred between workspaces in **Workspace Budget Mode**.

#### Steps

1. Go to **Dashboard → Workspaces tab**
2. Open the **⋯ (three-dot menu)** for a workspace
3. Select **Manage Credits**
4. Choose a source workspace
5. Enter the credit amount
6. Review updated balances
7. Click **Transfer**

***

### Credit Behavior

* Each workspace consumes credits from its own balance (in budget mode)
* The Primary Workspace reflects the remaining organizational balance
* If a workspace runs out of credits, usage is blocked until more credits are assigned

***

### Transfer Rules

* Credits can be moved between any workspaces with available balance
* Transfers cannot exceed available credits in the source workspace
* Changes apply immediately

***

### Deletion Impact

* Remaining credits in a deleted workspace return to the **Primary Workspace**
* The Primary Workspace cannot be deleted

***

### Why This Matters

* Enables controlled distribution of credits
* Prevents uncontrolled usage
* Provides visibility at the workspace level
* Ensures accountability across teams