# Allocation Thresholds

> Source: https://parallelworks.com/docs/organization-admin/billing/thresholds

# Allocation Thresholds

This page explains how to set and monitor allocations for your organization's groups. When a group reaches its allocation total, its users will no longer be able to start clusters.

You can also set [custom allocation thresholds](/docs/organization-admin/billing/thresholds#setting-allocation-thresholds) for your organization. This feature can alert users when their group approaches its allocation total as well as freeze or shut down clusters when an allocation total is reached.

:::tip Flexible allocation system

If your organization uses the [flexible allocation system](/docs/organization-admin/billing/flexible-allocation-system), thresholds apply to [allocations](/docs/organization-admin/billing/allocations) instead of group allocations, and budgets are set on the **Allocations** page rather than the **Groups** page. See [Thresholds under the flexible allocation system](#thresholds-under-the-flexible-allocation-system) below.

:::

:::info Note

The steps included on this page can only be completed by **ACTIVATE platform administrators** and users with the `org:admin` role. For more information, please see [**About Group Roles**](/docs/organization-admin/#about-group-roles).

:::

## Setting Allocations

From the **Organizations** list, select your organization. In the sidebar, under **Managing Groups**, click **Groups**.

On the **Groups** page, click **Edit allocations**.

![Screenshot of the user clicking the Edit allocations button.](/content-images/docs/organization-admin/billing/thresholds/click-edit-allocations.png?v=5a253d05)

Enter a value in a group's **Allocation** field. This number is measured in U.S. dollars.

Click **Save allocations**.

![Screenshot of the user clicking Save allocations.](/content-images/docs/organization-admin/billing/thresholds/click-save-allocations.png?v=f6933979)

Once you've set an allocation total, a group's accumulated costs will appear in the **Allocation used** column.

![Screenshot of the allocation usage appearing in the Allocation used column.](/content-images/docs/organization-admin/billing/thresholds/allocations-used.png?v=f36a8938)

## Setting Allocation Thresholds

From the **Organizations** list, select your organization. In the sidebar, under **Billing**, click **Thresholds**.

Click **Add**.

![Screenshot of the user clicking the Add button on the Thresholds page.](/content-images/docs/organization-admin/billing/thresholds/click-add-threshold.png?v=d250793c)

### Configure Allocation Thresholds

You can configure your allocation threshold with the settings outlined below.

![Screenshot of all allocation threshold settings.](/content-images/docs/organization-admin/billing/thresholds/blank-add-threshold-page.png?v=a1b1f708)

#### Threshold(%)

Use this field to set the allocation threshold as a percentage from `0` to `100`. For example, if a group's allocation total is $5,000, an `85%` threshold will affect users when their total spend reaches $4,250.

#### Use realtime data

Use this toggle button to enable real-time cost tracking for your threshold.

By default, this option is set to `No`. If you don't enable real-time cost tracking, the cost tracking will be calculated using the true cost data from CSPs.

#### Actions

Use these checkboxes to select the actions for your threshold. Options include:

- **Notify**: Users receive an alert via email.
- **Freeze**: Users will not be able to start new clusters.
- **Shutdown**: All clusters will be shut down.

You can select more than one action at a time for your threshold alert, especially if you want users to receive a notification for `freeze` or `shutdown`.

:::info Note

The **Shutdown** action only shuts down clusters. It does not delete storage or any other resources.

:::

#### Send to Group

Use this toggle button to send the alert email to all users in a group whenever it reaches its allocation threshold.

By default, this option is set to `Yes`.

#### Extra Recipients

Use this field to enter email addresses for additional users who will receive the threshold alert email.

:::info About Alerts

If you want users to be notified about a threshold for the `freeze` or `shutdown` actions, you have to add the `notify` action too.

:::

### Save Allocation Thresholds

After you've customized the settings above, click **Save Allocation Threshold**.

![Screenshot of the user clicking Save Allocation Threshold.](/content-images/docs/organization-admin/billing/thresholds/click-save-allocation-threshold.png?v=48275960)

Your new allocation threshold will appear in the **Thresholds** list.

## Editing Allocation Thresholds

In the **Thresholds** list, hover over a threshold and click the edit icon  to change it.

![Screenshot of the user clicking the edit icon for an allocation threshold.](/content-images/docs/organization-admin/billing/thresholds/click-edit-allocation-threshold-icon.png?v=bf8106e9)

Next, you'll see the threshold's configuration page, where you can edit any of the settings in [**Threshold Configuration**](#configure-allocation-thresholds) above.

Click **Save Allocation Threshold** when you're done making changes.

## Deleting Allocation Thresholds

To remove a threshold, open its row menu and click **Delete**.

![Screenshot of the user clicking Delete for an allocation threshold.](/content-images/docs/organization-admin/billing/thresholds/click-delete-allocation-threshold-icon.png?v=b8e3a7cf)

## Thresholds under the flexible allocation system

On the flexible allocation system, the same thresholds are evaluated against every allocation in your organization, using each allocation's **Used** amount, or its **Estimated** amount when **Use realtime data** is on.

- **Only the highest crossed threshold applies.** For example, with a freeze at 90% and a notify-only threshold at 100%, an allocation at 105% notifies but is no longer frozen. Put freeze or shutdown on your highest threshold.
- **Notify** emails the members of the groups the allocation is shared with (and **Extra Recipients**) once per threshold level. Raising the allocation's total re-arms the email.
- **Freeze** refuses new resources, starts, and moves onto the allocation. Running resources keep running.
- **Shutdown** stops every cluster and deletes every standalone instance in the resource groups that bill the allocation or any of its child allocations, and keeps doing so while the allocation stays over the threshold. Storage is not affected.
- An allocation with a total of **0** has no budget and blocks new work even without thresholds.
- The [Allocation Start Date](/docs/organization-admin/settings/policies#allocation-start-date) policy, when set, resets the usage that thresholds compare against once a year.
