> For the complete documentation index, see [llms.txt](https://learn.moselle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.moselle.io/planning-and-execution/replenishment/supply-planning/create-a-supply-plan.md).

# Create a Supply Plan

Create a Supply Plan in Moselle — choose the plan type, set a coverage period and forecast, pick a build method, and learn how versions and rebuilds behave.

{% hint style="info" %}
**Quick Answer:** Go to **Production** in the left sidebar (under **Planning & Execution**), click **Create Production Plan**, and choose **Supply Plan**. Name the plan, set a coverage period, pick the forecast it should plan against, choose a build method, and click **Create Supply Plan**. Moselle builds the first version in the background and opens the plan when it is ready. The form takes about 2 minutes; the build usually takes a few minutes.
{% endhint %}

## Prerequisites

**Time Required:** 2 minutes to create, a few minutes to build\
**Difficulty:** Intermediate

Before you begin, make sure you have:

* [ ] A forecast (your Master Plan or a saved scenario) covering the months you want to plan
* [ ] Your **Supply Chain map** built, with lead times on every connection — see [How Do I Map My Supply Chain?](/operations/inventory/supply-chain-network.md)
* [ ] A **catalog** uploaded for every supplier you buy from — see [Supplier Catalog](/operations/suppliers/supplier-catalog.md)
* [ ] Optionally, a `safety_stock` custom attribute on products that need a buffer — see [Where Do I Set Supply Planning Conditions?](/planning-and-execution/replenishment/supply-planning/supply-planning-conditions.md)

{% hint style="warning" %}
A supply plan plans **all your warehouses together**. There is no warehouse picker in the dialog — the map decides which sites are in scope. If a warehouse is missing from the plan, add it to the Supply Chain canvas and give it a source or an inbound lane, then rebuild.
{% endhint %}

## Step-by-Step Instructions

{% stepper %}
{% step %}

### Open the Plans list

Click **Production** in the left sidebar, under **Planning & Execution**. You land on the Plans list, where replenishment plans, allocation plans, and supply plans all appear together, grouped under the forecast they were built from.

**Expected Result:** You see a **Create Production Plan** button at the top right.
{% endstep %}

{% step %}

### Choose the plan type

Click **Create Production Plan**. A dialog asks **"How do you want to plan production?"** with two cards:

* **Replenishment Plan** — Reorder quantities per item from your forecast. Quick to set up and easy to review.
* **Supply Plan** — Plans across your whole supply network — warehouses, suppliers and lead times.

Select **Supply Plan** and continue.
{% endstep %}

{% step %}

### Fill in the plan details

The **Create Supply Plan** dialog asks for four things:

| Field                       | What to enter                                                                                                                                                                              |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Plan Name**               | Something you will recognise on the list later, e.g. "Q4 network plan"                                                                                                                     |
| **Coverage Period**         | The first and last month the plan should cover. Pick a window long enough for your longest lead time plus the months you want to see ahead.                                                |
| **Forecast**                | The demand the plan runs on. Your **Master Plan** is listed first; saved scenarios appear under **Previous Plans**.                                                                        |
| **How should we build it?** | **Simple regression** — Moselle suggests the orders needed to cover your targets. **Start blank** — Moselle snapshots demand and the orders you already own, and you add the rest by hand. |

Most teams should start with **Simple regression**. Choose **Start blank** when you want an empty canvas that still shows your demand and existing purchase orders — for example, to enter a plan you have already agreed elsewhere.
{% endstep %}

{% step %}

### Create and wait for the build

Click **Create Supply Plan**. You will see **"Supply plan created — building now"** and the plan page opens in its building state.

**Expected Result:** The header shows the plan name with a **Building** badge. When the build finishes, the grid appears automatically — you do not need to refresh.

{% hint style="success" %}
Your first version is ready. Head to the **Total Overview** tab to see what Moselle is suggesting.
{% endhint %}
{% endstep %}
{% endstepper %}

## What Is on the Plan Page Header?

Once the plan opens you will see:

| Element                       | What it tells you                                                                               |
| ----------------------------- | ----------------------------------------------------------------------------------------------- |
| **Back arrow**                | Returns you to the Plans list                                                                   |
| **Plan name and build stage** | Ready, Building, or Build failed                                                                |
| **Demand Plan**               | The forecast this plan is built from — click it to open the forecast                            |
| **Coverage Period**           | The first and last month planned — click it to open the plan **Settings** and change it         |
| **Last updated**              | When the plan last changed                                                                      |
| **Version picker**            | Every build of this plan, newest first (v1, v2, v3…)                                            |
| **Actions menu (gear icon)**  | **Settings** to change the name, coverage period, or forecast; **Rebuild** to run a fresh build |

A supply plan always covers every warehouse on your Supply Chain map, so there is no scope or warehouse shown in the header.

## How Do Builds and Versions Work?

**Every build creates a new version.** The plan itself is just the header — name, forecast, coverage period. The numbers you see belong to a version, and the version picker lets you look back at earlier builds.

* **Current version** — the newest successful build, and the only one you can edit.
* **Earlier versions** — selectable from the picker in read-only mode, so you can compare what the plan looked like before.
* **Failed builds** — also selectable, so you can read the error instead of hitting a dead end. Fix the cause and click **Rebuild**.

### What happens when I rebuild?

Click **Rebuild** in the actions menu whenever your forecast, inventory, or map has changed. Moselle:

1. Takes a fresh snapshot of demand and opening stock
2. **Regenerates every suggested order** against the new numbers
3. **Carries forward every order you have staged or placed** into the new version
4. Leaves archived orders behind

Your decisions survive; Moselle's proposals refresh. That is the whole point of the [Suggested → Staged → Placed](/planning-and-execution/replenishment/supply-planning/suggested-staged-and-placed.md) lifecycle.

{% hint style="warning" %}
While a build is running, every change to the plan is refused, and the numbers on screen belong to the previous version. Wait for the **Building** badge to clear before editing. A coverage-period change is also blocked during a build.
{% endhint %}

### Plan statuses on the Plans list

| Status        | Meaning                                                                                    |
| ------------- | ------------------------------------------------------------------------------------------ |
| **Building**  | A build is in progress. The list refreshes itself while any plan is building.              |
| **Ready**     | The current version built successfully and can be opened and edited                        |
| **Failed**    | The latest build stopped before completing. Open the plan to read the error, then rebuild. |
| **Not built** | The plan exists but has never completed a build                                            |

The **Last activity** column shows when the current version finished building.

## Frequently Asked Questions

### Can I change the coverage period after creating the plan?

**Answer:** Yes. Click the **Coverage Period** in the plan header, or open the actions menu (gear icon) and choose **Settings** — it is the same dialog you used to create the plan. Saving a new coverage period triggers a rebuild against the new window. You cannot change it while a build is running.

### Can I pick which warehouses the plan covers?

**Answer:** Not from the dialog. A supply plan always plans every warehouse on your Supply Chain map together. To leave a site out, remove it from the map or archive the warehouse.

### What is the difference between "Simple regression" and "Start blank"?

**Answer:** **Simple regression** fills the plan with Moselle's suggested purchases, production runs, and transfers. **Start blank** builds the same demand and inventory picture — including purchase orders you already have open — but proposes nothing, so every order in the plan is one you add yourself.

### Why did my plan come back with no suggestions?

**Answer:** Check three things: the forecast has demand in the coverage period, the Supply Chain map has a source or inbound lane for each warehouse, and the plan was built with **Simple regression** rather than **Start blank**.

### How do I delete a supply plan?

**Answer:** Use the row actions (⋮) on the Plans list and choose **Archive**. Archived plans are removed from the list; the purchase orders you placed from them are unaffected.

## Troubleshooting Common Issues

| Problem                                                   | Solution                                                                                                                                               | Time to Fix |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------- |
| **I don't see the Supply Plan card** when creating a plan | Supply planning may not be enabled for your account yet. Contact your Moselle team.                                                                    | —           |
| **"Supply planning isn't enabled"** on the plan page      | Same cause as above — reach out to your Moselle team                                                                                                   | —           |
| **"The last build failed"** banner                        | Open the failed version from the picker to read the error. Most failures trace back to a missing forecast or an incomplete map. Fix, then **Rebuild**. | 5 minutes   |
| **Plan has been "Building" for a long time**              | Large networks take longer. Refresh the page; if it stays stuck, try **Rebuild**.                                                                      | 2 minutes   |
| **A warehouse is missing from the plan**                  | Add it to the Supply Chain canvas with a source or inbound lane, then rebuild                                                                          | 5 minutes   |
| **"Pick a start and end date for the coverage period"**   | Both dates are required, and the end must be after the start                                                                                           | 1 minute    |

## Related Guides

{% content-ref url="/pages/Cuc2FOsrGDHotWXQnq8o" %}
[Supply Plan Views](/planning-and-execution/replenishment/supply-planning/total-overview-vs-monthly-breakdown.md)
{% endcontent-ref %}

{% content-ref url="/pages/cInnEqUhHY1rzz2BSgvs" %}
[Suggested, Staged & Placed Orders](/planning-and-execution/replenishment/supply-planning/suggested-staged-and-placed.md)
{% endcontent-ref %}

{% content-ref url="/pages/8QlNv4eTnXy8INtmWeyS" %}
[Create a Replenishment or Allocation Plan](/planning-and-execution/replenishment/core-workflow/create-a-production-plan.md)
{% endcontent-ref %}