Overview
Credits are the currency used to access AI-powered features on the platform. Each organization receives a pool of credits that are shared across all teams and users within that organization.
How Credits Work ?
Credit Grants
Credits are added to an organization through grants. A grant is a deposit of credits with the following properties:
Amount: The number of credits deposited.
Expiration date (optional): When the grant expires. After this date, any unused credits from this grant are lost.
Grants are independent and additive. If an organization receives a grant of 10 credits, then later a grant of 5 credits, they have 15 credits available in total. Each grant is a separate deposit — they do not replace or override each other.
Credit Balance
The organization's credit balance is calculated as follows:
Total = Sum of all initial amounts from active (non-expired) grants.
Left = Sum of all remaining amounts from active (non-expired) grants.
Used = Total minus Left. This is computed automatically — it is not stored separately.
Expired grants are fully excluded from the balance. If a grant expires with remaining credits, those credits are lost.
Consuming Credits
When a user triggers a feature that costs credits, the system deducts from the organization's available grants using the following rules:
Expiring grants are consumed first. The grant closest to its expiration date is used first. This maximizes the value of credits before they expire.
Permanent grants are consumed last. Grants without an expiration date are only used after all expiring grants have been exhausted.
Consumption spans multiple grants. If a single feature costs more than what remains in one grant, the system automatically takes the rest from the next available grant.
Refunds
If a user is not satisfied with an AI-generated result (e.g., downvoting an Action Plan), the credits consumed for that action are refunded. A refund restores the credits to the most recent active grant and marks the original consumption as "Refunded."
Features That Consume Credits
Feature | Cost per use | Trigger |
Report | 0.50 | Publishing or duplicating a report |
Action Plan | 0.50 | Generating an action plan |
Agent Recommendation | 0.25 | Accepting an agent recommendation |
Topic Detection | Variable | Running topic detection on feedback (cost scales with volume) |
Usage Page
Organization admins can view credit usage from the Settings > Usage page. This page shows:
Organization balance: Total credits, credits used, and credits remaining with a visual progress bar.
Team breakdown: Credit usage per team, with optional monthly limits that admins can set for each team.
Credit usage history: A detailed log of every consumption, including the feature used, the user who triggered it, the cost, and whether it was paid or refunded.
Real-Time Updates
The credit balance is updated in real-time across the application. When credits are consumed or refunded, all connected users in the organization see the updated balance immediately without needing to refresh the page.
Key Behaviors
Credits from expired grants are lost — they cannot be consumed or refunded.
There is no automatic recharge — new credits must be granted by a CS manager.
Refunded credits are not counted as consumed in the usage history.
Each team can have an optional monthly credit limit set by an admin, but this does not prevent consumption — it is informational.
