# Usage Projection

Usage Projection helps you estimate how many credits a Workspace may use in a future period. It starts from the same usage records described in [View Your Credit Usage](/billing/credits/view-credit-usage.md), then lets you build a projection and view how that projection affects your credit allocation.

Open Workspace Settings, select "Usage", then select "Projection".

## Build a Projection

Usage Projection opens in the "Credit Calculator". This is the setup state where you choose the scenario, time window, display units, and usage assumptions before you view the chart.&#x20;

<figure><img src="/files/lfrIzGNV7bASrojUf12z" alt="" width="563"><figcaption><p>The numbers labeled in the image corresponds to the numbered list below.</p></figcaption></figure>

1. [**Modes**](#modes)
2. [**Configuration**](#configuration)**:** Add a new usage type, change the Projection Basis, Projection Length, and the configuration settings
3. [**Usage Type Assumptions**](#usage-assumptions)
4. [**Summary**](#usage-summary)**:** View the total projected credit usage over the specified projection length period.

### Modes

The mode controls how the calculator fills in usage assumptions.

| Mode         | Use it when                                                                       |
| ------------ | --------------------------------------------------------------------------------- |
| Current Rate | You want to project recent usage forward without changing individual usage types. |
| Customize    | You want to start from current usage and adjust one or more usage types.          |
| From Scratch | You want to start from zero and add only the usage types you expect to use.       |

* **Current Rate:** is the fastest way to answer "what happens if usage keeps going like this?" The calculator uses the selected basis window to fill in the usage type rows.
* **Customize:** keeps the current usage types in the calculator, then lets you change individual rates. Use it when you expect a known change, such as more uploads, fewer inference requests, or a new deployment pattern. You can also add another usage type with the plus button or "Add usage type".
* **From Scratch:** starts with an empty "Build your projection" state. Use "Add usage type" to search or browse available usage types by category, such as Deploy, Training, and Dataset. Use it when you want to model a planned workflow or deployment that is different from current Workspace activity.

### Configuration

<figure><img src="/files/D25jDw1ITx4N88X3HLER" alt="" width="563"><figcaption></figcaption></figure>

1. The plus icon can be used to add a new usage type
2. **Based on**: When using the "Customize" mode, you can set the length of historical usage to base projections on. The length to "look backwards" on.
3. **Length**: How long to project forward, based on the assumptions.&#x20;
4. **Show as**: You can change how the projection scenario usage types are displayed
   1. "Show values as": You have the option to set the usage scenario in either units of usage or the number of equivalent credits
   2. "Timeframe": You can also configure whether to configure the frequency/interval between Day/Week/Month

### Usage Type Assumptions

The calculator groups usage types by category, such as Deploy or Dataset. Each row shows the estimated usage amount and the approximate credit value for that usage type.

1. **Starts at:** This sets the starting rate. Use the current rate when you want to start from observed usage, or enter a custom rate.
2. **Then:** This sets what happens after the starting rate. Choose "Stays the same" for a fixed rate, or "Changes" to model usage going up or down over time.

### Usage Summary&#x20;

Use "Reset all" to clear custom assumptions and return to the default assumptions for the selected mode. The total at the bottom of the calculator updates as you change the mode, window, length, and usage assumptions.&#x20;

Click "Show Projection" when the total represents the scenario you want to view.

## View the Projection

After you click "Show Projection", Usage Projection switches from the calculator to the projection view. This state shows the chart, summary cards, save controls, and the assumptions used for the projection.

The chart shows historical usage and projected usage in the same view. Use "Daily" to inspect day-by-day usage, or "Cumulative" to see the running total across the projection window.

The controls above the chart keep the projection editable:

* "Based on" changes the historical window used for the starting rate.
* "Length" changes how far forward the projection runs.
* "Assumptions" shows whether the projection uses current usage or custom usage. Use "Customize Assumptions" to return to the Credit Calculator.

The summary cards translate the projection into billing planning.

| Summary                      | Meaning                                                                                                                                                                              |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Projected Credit Use         | Total credits projected across the selected future period.                                                                                                                           |
| Projected Additional Credits | Credits projected above the available credits for the relevant billing cycle. Available credits include included credits and [Prepaid Credits](/billing/credits.md#prepaid-credits). |

If the projection stays within your available credits, the summary shows that the Workspace is expected to stay within its credit allocation. If the projection exceeds available credits, the summary shows the estimated additional credits. When [Flex Billing](/billing/credits/enable-or-disable-flex-billing.md) is enabled and the projection shows additional credits, the page can also show a prompt to contact Sales about volume rates.

### How the Estimate Works

Usage Projection calculates the daily average for each usage type in the "Based on" window. "Current Rate" projects those averages forward. "Customize" and "From Scratch" apply your fixed or gradual assumptions before the total is compared against the billing cycles covered by the projection length.

Choose a shorter basis window when recent usage is more representative than older usage. Choose a longer basis window when usage is uneven and you want the estimate to smooth out spikes.

Usage Projection is an estimate. Recent usage can take time to appear, and future activity can differ from the historical window you choose.

## Save and Share a Projection

Click "Save" to save a projection. In the "Save Calculation" modal, add a name and optional description, then save the calculation. Use the file icon to open an existing saved projection.

Saved projections preserve the scenario and a snapshot of the usage data, billing context, and feature catalog used for the estimate. This makes saved projections useful for comparing plans over time because later usage changes do not silently rewrite the original calculation.

Use "Open Saved Projection" to return to a saved calculation. After a projection is saved, "Copy link" becomes available so you can share the projection with someone who has access to the Workspace.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.roboflow.com/billing/credits/usage-projection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
