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

# Viewing customers entitlement usage

To view a customer's metered entitlement usage:

1. Open the **Entitlement usage** tab in the customer details screen to see current usage and historical usage over time.
2. Use this section to identify customers nearing their quota, exceeding it, or surpassing their allocated usage.

<img src="https://mintcdn.com/stigg/ghlUDOmd1mRIOf61/images/docs/169e8c3-Screenshot_2024-02-16_at_1.16.38.png?fit=max&auto=format&n=ghlUDOmd1mRIOf61&q=85&s=4a1ea9d18eb06c5bbcbdccb2d44045d2" alt="" width="2464" height="944" data-path="images/docs/169e8c3-Screenshot_2024-02-16_at_1.16.38.png" />

3. If automatic usage resets are enabled, review the visible reset period (monthly, weekly, etc.) and the upcoming reset date.

<img src="https://mintcdn.com/stigg/ghlUDOmd1mRIOf61/images/docs/1a6b1f3-Screenshot_2024-02-16_at_1.16.44.png?fit=max&auto=format&n=ghlUDOmd1mRIOf61&q=85&s=2b83d0518cef8913abe73fddfb80dae8" alt="" width="2462" height="950" data-path="images/docs/1a6b1f3-Screenshot_2024-02-16_at_1.16.44.png" />

4. Review the usage-over-time chart to identify usage patterns.

<img src="https://mintcdn.com/stigg/FdQMosJ2Bzlx8vcI/images/docs/6a981fd-Screenshot_2024-02-16_at_1.16.56.png?fit=max&auto=format&n=FdQMosJ2Bzlx8vcI&q=85&s=5338fa0e900b232a381ddf08cddf6fc1" alt="" width="2454" height="1194" data-path="images/docs/6a981fd-Screenshot_2024-02-16_at_1.16.56.png" />

5. If usage includes multiple dimensions, select a dimension to break down the chart.

<img src="https://mintcdn.com/stigg/UlAt5XRaB6FPzp-f/images/docs/08406c0-image.png?fit=max&auto=format&n=UlAt5XRaB6FPzp-f&q=85&s=3d8911df732a1c5c4ed9b10b409aa6b2" alt="" width="2332" height="916" data-path="images/docs/08406c0-image.png" />

6. When multiple active subscriptions exist, use the dropdown menu (top-left) to choose the relevant subscription.

<img src="https://mintcdn.com/stigg/rbfzdbhZ6y5pB9n-/images/docs/9b72ee5-Screenshot_2024-02-16_at_1.13.21.png?fit=max&auto=format&n=rbfzdbhZ6y5pB9n-&q=85&s=9658ff6b2f2f77b77f35e63f5b7353ac" alt="" width="2462" height="1154" data-path="images/docs/9b72ee5-Screenshot_2024-02-16_at_1.13.21.png" />

7. When reporting usage programmatically, click **Refresh** to load the most up-to-date usage.

### Updating usage

To update a customer’s current usage:

1. In the **Entitlement usage** section, click the feature you want to update to open its usage graph.
2. Click **Add usage record**.
3. In the side panel, provide the following:
   * **Update behavior**
     * **Delta**: increment or decrement usage from the current value.
     * **Set**: define the new absolute usage value.
   * **Value**: the amount to apply.
4. Review the **Preview** section to see the effect on current usage.
5. Confirm the update.

<img src="https://mintcdn.com/stigg/FdQMosJ2Bzlx8vcI/images/docs/717ead1-Screenshot_2024-02-16_at_1.17.34.png?fit=max&auto=format&n=FdQMosJ2Bzlx8vcI&q=85&s=4c7df21894d28a5f928a339a80a27d7c" alt="" width="3094" height="1310" data-path="images/docs/717ead1-Screenshot_2024-02-16_at_1.17.34.png" />

<img src="https://mintcdn.com/stigg/_E1NPxWRKvYZ5hDE/images/docs/8149706-Screenshot_2024-02-16_at_1.17.21.png?fit=max&auto=format&n=_E1NPxWRKvYZ5hDE&q=85&s=b128a84ca2b18ba825fc61cff09d43b3" alt="" width="3094" height="1314" data-path="images/docs/8149706-Screenshot_2024-02-16_at_1.17.21.png" />

<Warning>
  To avoid discrepancies, update usage in Stigg **only after** relevant resources have been provisioned or de-provisioned in your application.
</Warning>

<Note>
  1. Updating usage is currently supported only for **calculated usage**-based metered features. Support for event-based metering is planned.
  2. Usage records are added using the current timestamp. Support for back-dated usage is on the roadmap.
</Note>