# Demand

The Demand module is where you explore and manage your demand forecasts. It lets you browse your full product catalog, review AI-generated probabilistic forecasts alongside historical demand, and adjust the final forecast when needed. Depending on your setup, you may also see **Firm Demand** (confirmed orders from your ERP) and an **External Forecast** (imported from MRP or other sources) alongside the AI forecast. You can switch between three dimensions — **Product**, **Tag**, and **Customer** — to analyze demand at the granularity that suits your workflow. The Demand module supports **multi-site work**: when multiple sites are selected, you can review, challenge and edit forecasts for all your sites in a single workspace, with each product clearly identified by its site.

### Dimensions

Use the **Dimension** toggle in the top-right corner to switch how demand data is organized:

* **Product** — Lists every product (SKU) for the selected site. Each row shows the reference number and product name. When multiple sites are selected, each product also displays which site it belongs to. This is the default view and the most granular level of analysis.
* **Tag** — Groups products by tag. Each row displays the tag name, its tag category, and the number of products it contains. Selecting a tag opens an **aggregated demand curve** that combines the demand of all products under that tag. Use this view to analyze demand at a higher level (e.g. by product family, ABC class, or any custom grouping).
* **Customer** — Displays demand broken down by customer, useful when your forecasting process is customer-driven.

### Views and filters

The Demand module comes with several built-in views accessible as tabs at the top of the page:

* **Default view** — The standard product list.
* **Forecast accuracy** — Highlights how well past forecasts matched actual demand.
* **New products** — Surfaces recently added products that may need attention.
* **Outliers** — Flags products with unusual demand patterns.

You can also create custom views using the **+** button.

Use the **Columns** sidebar to customize which columns are displayed in the list — choose from general product info, demand metrics, and inventory columns. See [KPIs](/concepts/kpis.md) for a full reference of available metrics. One notable column is **Demand Predictability**, a Flowlity-computed score that indicates how stable or variable a product's demand pattern is.

To narrow down the list, use the filter bar to search by name or reference, or filter by **Tags**, **Suppliers**, **Alerts**, and more. Hovering over a product row shows its values instantly converted to any configured alternate unit (Multi-Unit Display).

### Product detail view

When you click on a product from the list, you open the product detail view — the core of the Demand module. It is split into two parts: a **chart** and a **data table**.

#### Chart

The chart displays your demand history and forecasts over a configurable time range. Past data is shown as **solid lines** and future data as **dotted lines**. Several series can be toggled on or off:

* **Cleaned past demand** — Historical demand after Flowlity has removed anomalies and noise.
* **Raw past demand** — The original, unmodified demand data as received from your system.
* **Similar products past demand** — Demand from comparable products, used by the AI to improve forecasts for new or sparse items.
* **Final forecast** — The forecast that will be used downstream in Planning. It is computed as `max(Firm Demand, My Forecast or Flowlity Forecast)`, ensuring confirmed demand always acts as a floor.
* **Flowlity forecast** — The AI-generated probabilistic forecast, shown with a **confidence interval** that captures the range of likely outcomes.
* **Firm Demand** — Confirmed orders or consumption imported from your ERP. In the near term, Firm Demand acts as a floor on the Final Forecast.
* **External Forecast** — An optional imported forecast (e.g. from MRP or marketing) displayed for reference only; it does not feed into the Final Forecast.
* **Events** — External events (e.g. promotions, market shifts) that may influence demand.

#### Data table

Below the chart, a table shows the same data in numeric form, broken down by period (e.g. monthly). You can switch between **Combined table** and **Split table** layouts. Key rows include:

* **Cleaned past demand** / **Raw past demand** — Compare what Flowlity cleaned versus the raw input.
* **Similar products past demand** — Contribution from similar products when applicable.
* **Anomaly adjustments impact** — Shows where Flowlity detected and corrected anomalies.
* **Final forecast** — The value that feeds into Planning.
* **Firm Demand** — Confirmed orders or consumption by period, imported from your ERP.
* **External Forecast** — Imported forecast by period (e.g. from MRP or marketing), shown for reference.
* **My forecast** — Your manual forecast override. You can enter values by editing cells directly, uploading an Excel file, or via integration. When working at an aggregated level (tag), input is automatically disaggregated to the product level. Even with a manual override, Firm Demand still acts as a floor on the Final Forecast.
* **Flowlity forecast** — The AI-generated forecast, marked as **Active** when it is driving the final forecast.
* **Forecast events** — Impact of events on the forecast.

### Actions

* **Keyboard navigation** — Use the left/right arrow keys to cycle through products without returning to the list.
* **Export** — Download demand and forecast data to CSV. See [Downloads](/settings/downloads.md) for more details.
* **Bulk tag assignment** — Select multiple products from the list and assign or remove tags in one step, without opening each product individually.
* **Bulk similar product update** — Update the current product ratio and end date of similar product usage across multiple products at once, directly from the product list.
* **Remove all MyForecast** — Clear manual forecast overrides for multiple products in a single action, returning those products to the Flowlity AI forecast. Useful when switching back after a period of manual forecasting.

### Forecast Studio

Forecast Studio is a dedicated workspace to build, test, and adjust forecasts at the product level. It combines Flowlity's global intelligence with your local expertise through two complementary layers:

* **Foundation Model** — A global model trained on all your data to capture broad patterns (seasonality, trends, correlations, external signals). It provides the baseline forecast.
* **Expert Models** — Product-level models applied on top of the Foundation forecast to refine it based on your operational knowledge.

#### What you can do

* **Tailor forecasts to each product** — Apply one or more Expert Models on top of the Foundation forecast and see the result instantly.
* **Recompute forecasts on demand** — Trigger a new forecast for a product or selection at any time, without waiting for the weekly run.
* **Apply Expert Models at scale** — Select multiple products or an entire tag and apply an Expert Model to all of them at once, accelerating the rollout of forecasting strategies across large catalogues.
* **Simulate and compare scenarios** — Switch models or adjust parameters to see the impact immediately, so you can make better decisions faster.

#### Available Expert Models

* **Average of recent periods** — Calculates the average demand over a selected period.
* **Average + Trend** — Adds a growth or decline percentage on top of the average of recent periods.
* **Seasonality** — Replicates a past period into the future.
* **Manual Seasonality** — Creates a seasonality profile with or without an annual trend, based on the average demand of a selected period.
* **Intermittent** — Handles sporadic demand by combining occurrence frequency with average demand volume.
* **Auto Model** — Automatically detects trend and annual seasonality.
* **Launch Model** — Designed for new products: learns the launch pattern of similar products, identified by Flowlity or selected manually.

#### Simulation credits

Forecast simulations are governed by a company-level credit system, ensuring fair usage and predictable costs.

### When to use it

Use the Demand module as your starting point in the planning workflow. Start from the product list to identify items that need attention (outliers, new products, low forecast accuracy), then open the product detail view to analyze the demand history, review the AI forecast and its confidence interval, and adjust the final forecast when needed — before moving on to the Planning module. Use the **Demand Predictability** score to prioritize which products deserve a closer review.

### Learn more

* [Views and filtering](/concepts/views-and-filtering.md) — How views, filters, and custom views work.
* [Demand forecasting explained](/concepts/demand-forecasting.md) — How the probabilistic forecast is generated.
* [Forecast events and demand adjustments](/concepts/forecast-events.md) — Events lifecycle and anomaly detection.
* [Comments](/concepts/comments.md) — Collaborate on products via the comment panel.
* [Set up and manage views](/how-tos/set-up-views.md) — Create and organize custom views.
* [Investigate and fix demand anomalies](/how-tos/investigate-demand-anomalies.md) — Review and act on anomaly corrections.
* [KPIs](/concepts/kpis.md) — Reference of available demand and inventory metrics.
* [Downloads](/settings/downloads.md) — Export demand and forecast data.


---

# 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.flowlity.com/modules/demand.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.
