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

# AI access and limits

> Monthly AI credit caps for the workspace, each member and each team, and turning AI off for someone.

## Overview

Admins can cap how many AI credits the workspace, each member and each team use in a month, and turn AI off for a person or a team. The limits live at **Settings → AI and automations → AI defaults → Access and limits**.

Usage is counted over your billing cycle. With no current billing period, it's the calendar month in UTC. The tab shows the day it resets.

![Access and limits: the workspace cap, the default for each member, and each team's or person's own limit.](https://docs.custral.com/images/screens/ai/access-and-limits-light.png)

Access and limits: the workspace cap, the default for each member, and each team's or person's own limit.

## Settings

| Setting | What it does | Default |
| - | - | - |
| **Monthly AI cap** (Workspace) | The most credits everyone and every automation can use in a cycle. The meter beside it shows this cycle's total. Empty means no cap. | No cap |
| **At the cap** | Appears once a workspace cap is set. **Pause AI** stops AI for everyone at the cap, admins and automations included. **Keep going, use top-ups** lets AI carry on using top-up credits. | Pause AI |
| **Cap each member at … credits a month** | The cap for anyone without a limit of their own. Empty means no cap. | No cap |
| **Admins exempt** | Admins skip member and team limits. The workspace cap still applies to them. | On |
| **Teams and people** | A limit for one team or member, added with **Add limit**. | None |

### A limit for a team or a person

**Add limit** opens **Add an AI limit**:

* **Team or member**: anyone who doesn't have a limit yet.
* **AI on**: off blocks Stella, email AI and auto-fill for them.
* **Monthly cap**: for a person, it replaces the workspace default. For a team, the cap is shared by everyone on it. Empty means no cap.

Each row shows **AI** (a switch), **Monthly cap**, and **Used this cycle**, with an **AI off** or **Capped** tag when the limit is blocking them. The pencil edits a limit. The bin removes it, and that team or person goes back to the workspace default.

**Background automations** (workflows and auto-fill) have no person to limit, so they count against the workspace cap only. The last line of the list shows what they used.

## Which limit applies

Custral checks these in order and stops at the first that blocks:

1. **The workspace cap**, when **At the cap** is **Pause AI**. It stops everyone, admins and automations too.
2. **Admins**, when **Admins exempt** is on, skip every rule below.
3. **A member's own limit** wins over their teams' limits and the default.
4. Otherwise, **any team** they're on with AI off, or at its shared cap, blocks them.
5. Otherwise, **the default for each member** applies.

## What members see

* **Before the limit.** At 90% of the limit closest to them, a member gets one notice a cycle, and the credit ring turns amber. Admins get the same notice for the workspace cap.
* **At the limit.** Stella shows a card that says which limit stopped it and when it resets. Email AI, auto-fill and the builders show the same words as a toast.
* **Ask an admin for more** sends the workspace's admins one notification, at most once a day per member. An admin sees **Open AI limits** instead.
* **Their own usage.** Below Admin, the Access and limits tab is read-only and shows **Your AI usage**: a meter against their cap, the reset day, and what it went on (Stella, Email, Auto-fill, Builders). Clicking the credit ring shows the same.

## Troubleshooting

| Symptom | Likely cause | What to check |
| - | - | - |
| "AI is turned off for you" | An admin turned **AI on** off for you, or for a team you're on | Ask an admin to check **Teams and people**. |
| "You've used your AI credits" | Your own limit, or the default for each member | Wait for the reset day shown, or choose **Ask an admin for more**. |
| "Your team has used its AI credits" | A team you're on reached its shared cap | An admin raises the team's **Monthly cap**. |
| "This workspace has used its AI credits" | The workspace cap with **At the cap** set to **Pause AI** | An admin raises the cap, or switches to **Keep going, use top-ups**. |
| "Your admins were already told today." | **Ask an admin for more** sends one notification a day per member | Nothing to do. Your admins have the request. |
| An admin hit a member limit | **Admins exempt** is off | Turn it on, or give the admin a limit of their own. |
| Workflows or auto-fill stopped, but members can still use Stella | Background automations count against the workspace cap only, and it's full | Raise the workspace cap, or choose **Keep going, use top-ups**. |
| A team or member is missing from **Team or member** | They already have a limit ("Every team and member already has a limit") | Edit their row with the pencil instead. |
| The fields are greyed out | The tab is read-only below Admin | Ask an admin. |

> [!NOTE]
>
> When reporting an issue, include the request id shown in the error toast. It links the in-app error to the server logs.

## Related

* [AI defaults](https://docs.custral.com/ai/ai-defaults.md): the other tabs on the same page.
* [Living notes](https://docs.custral.com/ai/living-notes.md): stop updating when a workspace reaches its AI limit.
* [The Stella chat](https://docs.custral.com/ai/stella-chat.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.