> 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

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