Diagnose forecast errors
Recognize the common root causes of a bad forecast and apply the right fix.
When a product shows a large forecast error, the first question is not "what should the number be?" but "why is the forecast wrong?". Most errors come from a handful of causes, and many of them trace back to the data the model learns from rather than to the model itself. This page helps you name the cause and pick the fix.
The three most common causes
1. A demand drop the model has not absorbed yet
What you see: demand has stayed lower for several months, but the forecast still follows the previous level.
Why it happens: Flowlity adapts quickly to a lasting change, except where seasonality is strong. The model also learns from the same period in previous years, so a drop in a month that was high last year takes longer to absorb.
How to check: in the product detail of Demand, turn on Raw past demand (N-1) and Raw past demand (N-2) from the chart legend. If the same months were high in previous years, seasonality is holding the forecast up.

What to do:
Check the cause with the commercial team. Is it structural (lost customer, delisted range, discontinued product) or temporary?
If it is structural and linked to a discontinued product, see End of life and product replacements below.
If it is structural and the product goes on selling at the new level, apply an expert model that follows recent demand, such as the Average of recent periods model or the Average + Trend model, in Product strategy > Forecast > Forecasting models. Click Compute forecast to see the result before the next weekly run.
If it is temporary, let the model continue, and watch the following reviews to see how fast it adapts.
2. A launch with little or no history
What you see: a new product with a few weeks or months of history and Low or No Demand predictability. Often a new version or color replacing an older product.
What to do:
For a brand-new product, apply the Launch model expert model: it learns the launch pattern of similar products, picked by Flowlity or by you.
For a product that replaces an older one, link the older product as a similar product so the model can borrow its history. See Product similarities.
3. Abnormal history
What you see: weeks that do not reflect normal demand, such as a drop caused by a stock-out, a one-off spike or dip, or a past promotion.
What to do: check the corrections the Demand anomaly agent made for shortages, outliers and past promotions: keep them, change their value or delete them, and add your own with Add past demand adjustment. See Investigate and fix demand anomalies. Confirm the cause before cleaning: a real one-time order is genuine demand, not noise.
Other patterns worth recognizing
End of life and product replacements
What you see: an important product whose demand falls to almost zero after a long stable period, while only one or two products remain in its family.
Why it happens: the product was discontinued or replaced, but the change did not reach Flowlity. The old product keeps a forecast, and the new one starts without history.
What to do:
Set the End of life date of the old product in Product strategy > Forecast, so it stops driving the plan. For many products, select them and use ⋮ > Edit product strategy > Edit lifecycle. An automation can also adjust the lifecycle on a schedule.
Link the replacement to its predecessor as a similar product, or ask your Flowlity contact to transfer the history.
Check the predecessor's remaining stock when validating orders for the replacement: in Planning, the Similar products stock series shows it.
If replacements are frequent, agree a regular process with your Flowlity contact (for example, a more frequent history reload) rather than fixing products one by one.

Cannibalization by a new variant
What you see: a new edition or variant grows while an existing one falls. Each SKU shows a large error, but the family total is close to the forecast.
What to do: judge accuracy at family or model level for these products: in the Demand list, click Group > Add group and group by the family tag category to read the family subtotal. Link the new variant to the existing one. If new editions are a normal part of your commercial model, keep this grouping in your review view.

A category-wide drop
What you see: demand falls across a whole category at the same time, without stock-outs.
What to do: check with the commercial team whether the cause is external (economic situation, a major event, a market change) and whether it is one-off or lasting. If a similar disruption is expected again in a known period, create a forecast event for that period. See Create and apply forecast events.
An unexplained drop
What you see: a sharp drop on one product without a stock-out, while similar products in the same family forecast well.
What to do: log it and ask the commercial or sales control team whether there is a reason, such as a commercial action, a customer change or a pricing decision. If there is a systematic cause, the planning team needs to know about it for the next forecast. If it is truly random, it cannot be forecast and should not drive changes to your process.
Quick reference
Demand lower for months, forecast still high
Drop not yet absorbed
Commercial team, N-1 / N-2 overlays
Wait and monitor, or treat as end of life
Demand lower for months, no seasonality
Lasting change
N-1 / N-2 overlays
Expert model on recent demand
Little history, low predictability
Launch or replacement
Launch model or similar product set?
Launch model, or link the predecessor
Zero or low weeks, then recovery
Stock-out
Shortage correction
Keep or change the correction
Single spike or dip
Outlier or one-off order
Outlier correction, commercial team
Keep, change or delete the correction
Demand near zero after a stable period
End of life or replacement
Product strategy, product family
Set End of life, link successor
One variant up, another down
Cannibalization
Family-level total
Review at family level
Whole category down
External event
Commercial team
Forecast event if it recurs
Sharp drop, no stock-out, siblings fine
Unknown
Commercial or sales control
Log and escalate
Related pages
Run a forecast accuracy review: where diagnosis fits in the review routine.
Investigate and fix demand anomalies: shortages, outliers and past promotions.
Product similarities: borrow history for replacements.
Demand: expert models, Product strategy and Compute forecast.
Forecast events and demand adjustments: how events and corrections change the forecast.
Demand forecasting explained: how the model learns from history.
Last updated