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

# Supply planning overview

> How to read the supply planning grid and act on replenishment recommendations.

## What this page is for

The **Supply Planning** page is a time-phased planning grid. It answers one question, period by period: is each product covered, about to run short, or overstocked — and it lets you act right there. Each product (SKU) is a row-group, each time bucket (day, week, or month) is a column, and under every product sit the metric rows you choose to see.

Spherecast also generates **replenishment recommendations** — suggested orders that appear in the Supply row — so you can turn a gap into a real order without leaving the grid.

## What you see

The grid has a **sticky left column** showing each product's SKU and title, then one cell per period stretching out to your time horizon. Above each product is a header row that can show **status pills**:

| Pill                        | Meaning                                                     |
| --------------------------- | ----------------------------------------------------------- |
| **Inactive**                | The product is not currently active.                        |
| **Discontinued**            | The product is being phased out.                            |
| Phase-out date              | The date the product is scheduled to stop.                  |
| **Stockout risk**           | The product is projected to run short in the horizon.       |
| **Expiration risk**         | Stock is projected to expire before it can be used or sold. |
| **Refreshing supply plan…** | Recommendations are recomputing after an edit.              |

The grid is **paginated** — use **Load more** at the bottom to pull in the next batch. The default sort is **Last 90 days sales**, so your biggest movers surface first.

Across the **top bar** you have **search**, **Filter**, **Display**, and an **Export** button.

## Key terms

| Term            | What it means                                                          |
| --------------- | ---------------------------------------------------------------------- |
| Bucket / period | One time column (day, week, or month).                                 |
| Granularity     | How wide each bucket is.                                               |
| Horizon         | How far into the future the grid runs.                                 |
| Recommendation  | A suggested replenishment order Spherecast proposes in the Supply row. |
| Scenario        | A saved what-if version of your plan.                                  |

## How it works

Out of the box the grid opens with **Monthly** granularity, a **1-year horizon**, the metrics **DOS - start** and **Supply** shown, and **Show recommendations** turned on. You change any of this from **[Filter & display](/guide/supply-planning/filter-and-display)**, and your choices persist across reloads.

The grid respects the currently selected **scenario**. When a scenario is active, **demand cells become editable** so you can run what-if changes and watch supply respond. See [Scenarios](/guide/scenarios/overview).

## The eight metrics

Each metric can be added as its own row. The pages below define them in depth:

* [DOS](/dos) — Days of Supply: how many days your stock covers.
* [WOS](/wos) — Weeks of Supply: the same coverage read in weeks.
* [Available](/available) — projected on-hand stock at the end of each period.
* [Demand](/demand) — expected outflow (sales and production draw).
* [Supply](/supply) — incoming stock, including recommendations.
* [Transfers](/transfers) — stock moving between your warehouses.
* [Expiration risk](/expiration-risk) — stock likely to expire unused.
* [Shortage](/shortage) — projected unmet demand.

## Where to go next

* [Filter & display](/guide/supply-planning/filter-and-display) — shape the grid.
* [Finished-good planning](/guide/supply-planning/finished-good-planning) — work sellable products.
* [Raw-material planning](/guide/supply-planning/raw-material-planning) — plan components by BOM.
* [Scenarios](/guide/scenarios/overview) — run what-if plans.

> **Tip:** If a product's numbers look stale right after you edit, watch for the **Refreshing supply plan…** pill — recommendations are recomputing in the background and will settle in a moment.