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

# Forecasting

> Predict demand and plan restocking

Stockful uses your sales history to predict future demand. Forecasting is available on all plans.

<Note>
  Forecasting uses the 30 days of sales history synced during setup, so predictions are available as soon as your initial sync completes. Accuracy improves over time as more data accumulates.
</Note>

## What you get

For each variant at each location:

* **Velocity** - how many units sell per day
* **Days of supply** - how long current stock will last at the current sales rate
* **Projected stockout date** - when inventory will run out if nothing changes
* **Reorder point** - when you should place a reorder to avoid running out (accounts for lead time and safety stock)
* **Recommended order quantity** - how much to order based on your restock strategy
* **Sell-through rate** - what percentage of inventory has sold over the last 30 days
* **ABC classification** - whether a SKU is an A (top revenue), B, or C tier item

## Where forecasts appear

* **Inventory list** - sortable columns for days of supply, velocity, reorder point, projected stockout, and stock status
* **Inventory detail page** - full breakdown of forecast metrics for a variant at a location
* **Reorder Recommendations report** - items that should be reordered based on velocity and lead time
* **ABC Analysis report** - revenue-based classification into A, B, and C tiers

## Global settings

Configure defaults for all SKUs in **Settings → Forecasting**. These apply to every variant unless overridden at the SKU level.

### Replenishment

| Setting          | What it controls                                                                                                                   |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Lead time**    | Days it takes to receive stock from your supplier (0–365, default 7). Longer lead time means earlier reorder recommendations.      |
| **Safety stock** | Extra days of buffer stock to keep on hand beyond lead time (0–365, default 3). Protects against demand spikes or shipping delays. |

### Velocity calculation

| Setting             | What it controls                                                                                                                      |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Velocity period** | Days of sales history to use when calculating how fast items sell (7–365, default 30). A longer period smooths out short-term spikes. |

### Restock strategy

| Setting               | What it controls                                                                                                                                                                                                                                                   |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Restock-to days**   | How many days of supply you want after restocking (1–365, default 30). Higher values mean larger, less frequent orders.                                                                                                                                            |
| **Demand adjustment** | A percentage modifier applied to velocity (-100% to +500%). Use this to account for anticipated seasonal changes - for example, +50% ahead of a busy period. Leave blank for no adjustment.                                                                        |
| **Sales grouping**    | How velocity is calculated for multi-location stores. **Per location** (default) calculates velocity separately at each location. **Combined** aggregates sales across all locations before calculating - useful when stock is fulfilled from a central warehouse. |

<Tip>
  When in doubt, set a slightly longer lead time than your actual average. It's better to reorder a few days early than to run out waiting for a shipment.
</Tip>

## SKU-level overrides

Not every product has the same supply chain. From **Settings → Forecasting**, click **SKU overrides** to customise settings per variant.

Each variant can override:

| Override                       | What it does                                                       |
| ------------------------------ | ------------------------------------------------------------------ |
| **Lead time**                  | Supplier-specific lead time for this SKU                           |
| **Safety stock**               | Custom buffer for high-value or volatile items                     |
| **Low stock threshold (days)** | Override the global days-of-cover low-stock threshold for this SKU |
| **Restock-to days**            | Custom restock target for this SKU                                 |
| **Demand adjustment**          | SKU-specific seasonal or promotional adjustment                    |

Leave a field blank to inherit the global default. The override table shows the inherited default value as a placeholder so you can see what each SKU will use.

You can search by product name or SKU, and reset individual overrides back to defaults.

### AI-suggested thresholds

On the SKU overrides page, click **Suggest with AI** to have Stockful's assistant recommend values for lead time, safety stock, low-stock threshold, and restock-to days. Suggestions are based on each SKU's actual sales history, variability, and supplier link. Each suggested field comes with a one-sentence explanation; you can apply suggestions individually or all at once. Bulk mode runs across many selected SKUs; the same suggestion is also available in the inventory detail modal for single-SKU tuning.

## Low-stock threshold

The low-stock alert fires when a SKU is projected to run out within **X days** at its current sales velocity (default 7). Because it's days-of-cover rather than a fixed unit count, the same threshold works for slow-movers and fast-movers without re-tuning per SKU.

### Units floor (for new SKUs)

Brand-new SKUs have no velocity history yet, so days-of-cover can't be computed. For those, Stockful falls back to a **units floor** - alert when stock drops to or below this many units (default 5). The floor only matters until the SKU has accumulated enough sales history; after that, the days-of-cover comparison takes over automatically.

Both settings live under **Settings → Tracking**.

### Settings hierarchy

When calculating forecasts, Stockful resolves each setting in order:

1. **SKU override** - if set on the variant, use it
2. **Supplier default** - if the variant is linked to a supplier with a default lead time, use that
3. **Global default** - the value from Settings → Forecasting

This lets you set sensible defaults globally, override at the supplier level for lead times, and fine-tune individual SKUs where needed.
