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

# Pricing Simulator

> Model what a pricing change would bill across real customer accounts before you make it: compare scenarios against a baseline, review revenue impact per account, and turn a scenario into a plan or draft subscription.

The Pricing Simulator shows what a pricing change would bill before you make it. You choose a set of customer accounts and a past billing period. You define one or more pricing scenarios. Alguna then prices each account under each scenario and shows the revenue impact. Use it before a price increase, a new tier structure, a discount change or a packaging change, when you need to know which accounts go up or down and by how much. Simulations do not change subscriptions or invoices. The real records change only when you choose to turn a scenario into a plan or subscription. For how pricing flows into billing, see [How Alguna works](https://alguna.com/docs/concepts/how-alguna-works.md).

> [!NOTE]
>
> Available on request: contact support or your account team to turn it on. It may depend on your plan.

The Pricing Simulator is available in the dashboard only. There is no public API for simulations.

## Key concepts

| Concept | What it is |
| - | - |
| Simulation | A named model with a currency. It holds one or more versions. |
| Version | A simulation period and a set of accounts, plus the scenarios to compare. |
| Scenario | A set of products and prices, with optional terms, that Alguna prices each account against. |
| Baseline | The scenario that represents current pricing. Other scenarios are compared against it. |
| Run | One calculation of every scenario in a version, for every account in that version. |

## Create a simulation

Open **Pricing Simulator** and select **New Simulation**. The **Create Simulation** dialog has two steps.

1. **Simulation**: enter a **Name**, an optional **Description** and the **Currency** the results are shown in.
2. **Initial Version**: choose the **Simulation period**, then choose how to pick accounts:
   * **Custom**: select the **Accounts** to include. At least one account is required.
   * **Plan**: select a plan. Alguna includes every account with a subscription on that plan and adds a baseline scenario that uses the plan's current pricing.

Select **Create Simulation** to open the new simulation.

Usage for metered products comes from the usage events recorded for each account in the simulation period.

## Add scenarios

Each scenario is one pricing option you want to test. Add a scenario from the scenario tabs:

* **Empty scenario** starts a scenario with no products.
* **Use existing** copies a scenario that is already in the version.

When you add a scenario through the **Add Scenario** dialog, you can choose a **Source Type**:

| Source Type | Starts from |
| - | - |
| Plan | The products and prices of an existing plan. |
| Subscription Version | The products and prices of a customer's existing subscription. |
| Custom | Nothing. You build the scenario from scratch. |

In a scenario you can:

* Select **Add Product** to add products from your catalog.
* Change the pricing model, prices and tiers of each product.
* Set custom terms: a discount (percentage or fixed), a **Minimum Spend**, a **Maximum Spend** and the billing interval.

Scenarios can be renamed, duplicated and deleted while the version is editable.

## Run the simulation

Select **Run Simulation** to price every account under every scenario. The version needs at least one scenario. The run happens in the background, and its status is shown on the page: Queued, Running, Completed, Failed or Cancelled. Select **Cancel Run** to stop a run that is in progress.

A version cannot be edited while a run is in progress. After a version has run, its scenarios and settings are locked so the results always match the inputs. To try changes, select **New Version**. The new version copies the scenarios, accounts and period of the version you are on. Use the version menu to switch between versions. The most recent one is marked as latest.

## Review results

Results are shown in three tabs.

### Overview

The scenarios, with a summary card for each one and a chart of revenue impact against the baseline. Switch between **Total** and **MRR** to see the figures as total billed in the period or as monthly recurring revenue.

### Account Analytics

Compares one scenario with the baseline, account by account. Choose the scenario to compare. The tab includes:

* **Account Impact Distribution**: how many accounts fall into each band of percentage change.
* **Account Impact Scatter**: each account's change, plotted against its current revenue.
* **Top 10 Winners** and **Top 10 Decreases**: the accounts with the largest increases and decreases.
* **Discount Efficiency** and **Price Sensitivity by Customer Tier**.
* A results table with one row per account.

Open an account from the results to see its simulated line items, subtotal, adjustments, total and usage breakdown.

### Top Line Analytics

Shows revenue across all selected accounts:

* **Revenue Over Time**: simulated revenue across the period for each scenario.
* **Product Revenue Mix** and **Charge Type Breakdown**: where revenue comes from.
* **Revenue Concentration**: how evenly revenue is spread across accounts.

## Use a scenario's pricing

After a run, you can turn a scenario into a real object. Open **Use pricing** on the scenario.

* **Create plan**: opens a new plan with the scenario's products and prices filled in, for you to review and save. See [Plans](https://alguna.com/docs/pricing/plans.md).
* **Create subscription**: pick an account. Alguna creates a draft subscription for that account with the scenario's pricing and opens it. The draft has no effect on billing until you activate it. See [Subscriptions](https://alguna.com/docs/subscriptions/overview-subscriptions.md).

## Permissions

To see simulations, a role needs permission to view simulations. To create, edit and run simulations, or to use a scenario's pricing, a role needs permission to manage simulations. See [Team and roles](https://alguna.com/docs/getting-started/team-and-roles.md).

## FAQ

**Does running a simulation change invoices or subscriptions?**
No. Live records change only when you use **Create plan** or **Create subscription**. Even then, the new subscription starts as a draft.

**Can I change a scenario after the simulation has run?**
Not in that version. Select **New Version** to get an editable copy, make your changes, and run it again. The earlier version keeps its results.

**Which usage does the simulation use?**
The usage events recorded for each account in the simulation period, priced under each scenario's pricing.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.