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

# AI Moderation Usage & Budget Guard

> Track your monthly AI moderation allowances and understand how Budget Guard keeps your community protected and your costs predictable on flat-rate plans.

If you're on a flat-rate AI Moderation package, your plan includes a **monthly allowance** for each moderation feature. social.plus tracks your usage throughout the month and, if an allowance is used up, automatically switches that feature over to **basic, rules-based moderation** — so your community stays protected and you're never charged extra.

This is called **Budget Guard**, and you can monitor it at any time from the Admin Portal or the Console.

<CardGroup cols={2}>
  <Card title="Predictable spend" icon="receipt">
    Flat-rate plans never bill overage. If an allowance runs out, moderation falls back to a basic mode instead of generating extra charges.
  </Card>

  <Card title="Always-on protection" icon="shield-check">
    Even after an allowance is reached, your community keeps a baseline level of moderation until your usage resets.
  </Card>
</CardGroup>

## How your usage is tracked

* **Tracked per feature.** Text & Metadata Moderation, Image Moderation, and Video Moderation (posted minutes) each have their own allowance — running low on one doesn't affect the others.
* **Counted across your whole organization.** Usage is combined across all of your applications, not capped per app.
* **Resets monthly.** Your usage counters reset on the **1st day of every month**, in line with your billing cycle.

<Info>
  Your monthly allowances are determined by your subscribed plan tier. If your community is growing and you'd like to review your tier, [contact support](https://ekoapp.atlassian.net/servicedesk/customer/portal/3).
</Info>

## Understanding your usage status

Each moderation feature shows a status badge based on how much of its monthly allowance has been used:

| Status       | Usage     | What it means                                                                                               |
| ------------ | --------- | ----------------------------------------------------------------------------------------------------------- |
| **Active**   | Below 75% | You're comfortably within your monthly allowance.                                                           |
| **At risk**  | 75–99%    | You're approaching your allowance for this feature. You'll see a notification so you can plan ahead.        |
| **Fallback** | 100%      | The allowance is used up. Budget Guard has switched this feature to basic moderation until your next reset. |

## What happens when an allowance is reached

When a feature's month-to-date usage reaches 100% of its allowance, Budget Guard activates **immediately and only for that feature**:

* Remaining content for that feature is moderated using **basic, rules-based moderation** (keyword and block/allow-list filtering) instead of AI moderation, so your community continues to be protected.
* All other features that haven't reached their limit continue to run on full AI moderation as usual.
* The feature automatically returns to full AI moderation at the start of your next billing cycle — no action needed on your part.

<Tip>
  **No surprise charges.** Flat-rate plans don't bill overage. Budget Guard exists precisely so that going over an allowance never results in an unexpected invoice.
</Tip>

## Where to check your usage

Usage is visible in two places — pick whichever fits how you work.

<Tabs>
  <Tab title="Admin Portal">
    Go to **Account → Plan details** to see a single, organization-wide view of your AI moderation usage across all applications.

    For each feature, you'll see:

    * The monthly allowance and how much you've used so far
    * The percentage used, with a visual progress bar
    * The date your usage will next reset
    * The current status (**Active**, **At risk**, or **Fallback**)

    <Frame>
      <img src="https://mintcdn.com/social-b97141fb/PlNqmi_JcaA0l3op/images/moderation-budget-portal.jpg?fit=max&auto=format&n=PlNqmi_JcaA0l3op&q=85&s=1eac88fbe525d6a88ace04c03fd5f2cd" alt="Admin Portal Plan details page showing AI moderation usage across all applications, with status badges and a notification about Budget Guard switching a feature to basic moderation" width="1440" height="1144" data-path="images/moderation-budget-portal.jpg" />
    </Frame>

    <Info>
      When any feature reaches **At risk** or **Fallback**, a notification banner appears at the top of the page with a link to **Contact support**. It can be dismissed — once dismissed, it won't reappear for you, though teammates who haven't seen it yet still will.
    </Info>
  </Tab>

  <Tab title="Console">
    Go to **Usage** in the left-hand navigation to see AI moderation usage for the application you're currently working in.

    For each feature, you'll see:

    * This application's usage compared with your other applications and the remaining allowance
    * The same allowance, percentage used, and status badge shown in the Admin Portal
    * The organization-wide total, for context on how your apps contribute to the shared allowance

    <Frame>
      <img src="https://mintcdn.com/social-b97141fb/PlNqmi_JcaA0l3op/images/moderation-budget-console.jpg?fit=max&auto=format&n=PlNqmi_JcaA0l3op&q=85&s=12c27c6474b9139d40c71c0c67dfae1c" alt="Console Usage page showing this application's AI moderation usage broken down against other applications and the organization-wide allowance" width="1496" height="1150" data-path="images/moderation-budget-console.jpg" />
    </Frame>
  </Tab>
</Tabs>

<Info>
  Usage shown in the Console and the Admin Portal is always kept in sync — whichever view you check, you'll see the same allowance, usage, and status for your organization.
</Info>

## Staying ahead of your limit

* **Check in regularly**, especially if your community's activity is growing month over month.
* **Watch for the At risk notification** — it gives you advance notice before a feature switches to basic moderation.
* **Reach out early.** If you expect to consistently approach or exceed an allowance, [contact support](https://ekoapp.atlassian.net/servicedesk/customer/portal/3) to talk through your options, including moving to a higher tier.
