> ## 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.

# Metered features

Metered features are usage-based features that track and optionally limit how much of a specific resource or service a customer consumes within a defined period.

## Usage limits

Metered features can be defined with a limit or without one (unlimited).

<img src="https://mintcdn.com/stigg/cwvUR-sZ1iKIoz2m/images/docs/aa6a4af-Screenshot_2024-05-16_at_15.10.43.png?fit=max&auto=format&n=cwvUR-sZ1iKIoz2m&q=85&s=fba467a235d5efbf9ac91e08b65a3d09" alt="" width="1104" height="846" data-path="images/docs/aa6a4af-Screenshot_2024-05-16_at_15.10.43.png" />

<img src="https://mintcdn.com/stigg/fP4soQQ7PxwZeQ0V/images/docs/e9872e5-Screenshot_2024-05-16_at_15.15.22.png?fit=max&auto=format&n=fP4soQQ7PxwZeQ0V&q=85&s=d9b1b6a1f5b3f6a02ae13cfe6ce5a5b3" alt="" width="1104" height="732" data-path="images/docs/e9872e5-Screenshot_2024-05-16_at_15.15.22.png" />

### Limit enforcement

To configure limit enforcement for metered features:

1. Set a usage limit for the feature.
2. Choose whether Stigg should **enforce** the limit or allow usage beyond it:
   * If the limit is **enforced**, Stigg will deny further access once the customer reaches the limit.
     * This configuration is known as a **hard limit** and is the default for all Stigg entitlements.
   * If the limit is **not enforced**, Stigg will continue granting access even after the limit is exceeded.
     * This configuration is known as a **soft limit**.
3. Review the table below for a summary of the two configurations:

|                                        | Hard limits                                                                       | Soft limits                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------------------------------------- | --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Customers can exceed the defined limit | ❌                                                                                 | ✅                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Useful for                             | 1. Enforcing access in free plans.2. Driving conversions, upsells and expansions. | 1. In enterprise plans, to prevent disruptions to customers' business - excessive usage is commonly leveraged for discussions with sales, CS and account executives about expansion and increased commitment. 2. When implementing an automatic smart upgrade flow to a higher tier based on customer usage instead of charging for overage - upgrades help increase recurring revenue, where overage charges are less predictable.3. During the initial integration with Stigg - companies that already have soft limits defined today and want to gradually rollout the integration with Stigg, can do so while activating enforcement at a later stage without any additional code changes. |

<Frame caption="Soft limit">
  <img src="https://mintcdn.com/stigg/rbfzdbhZ6y5pB9n-/images/docs/949ae6c-Screenshot_2024-05-16_at_15.16.51.png?fit=max&auto=format&n=rbfzdbhZ6y5pB9n-&q=85&s=1e1e047b06ca24a0d169584e1f02a582" width="1104" height="842" data-path="images/docs/949ae6c-Screenshot_2024-05-16_at_15.16.51.png" />
</Frame>

### Usage reset

Stigg can automatically reset measured usage at predefined intervals: **yearly**, **monthly**, **weekly**, **daily**, or **hourly**.

This is useful for usage-based features such as tracking the number of API calls per month.

<img src="https://mintcdn.com/stigg/_E1NPxWRKvYZ5hDE/images/docs/7fa36e5-Screenshot_2024-05-16_at_15.17.20.png?fit=max&auto=format&n=_E1NPxWRKvYZ5hDE&q=85&s=020c6597c6b6c6dfadbf2d0bd5407c4f" alt="" width="1104" height="842" data-path="images/docs/7fa36e5-Screenshot_2024-05-16_at_15.17.20.png" />

<Frame caption="Advanced usage reset configuration">
  <img src="https://mintcdn.com/stigg/zZAY_sXPTSVMcwio/images/docs/cb40080-Screenshot_2024-05-16_at_15.17.28.png?fit=max&auto=format&n=zZAY_sXPTSVMcwio&q=85&s=071d19fa7b6d9338c948ac98bf94ef69" width="1104" height="958" data-path="images/docs/cb40080-Screenshot_2024-05-16_at_15.17.28.png" />
</Frame>
