> 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/mo/key-capabilities/mo-workflows/mo-workflows-on-your-plans.md).

# Run Workflows on Your Plans

Learn how to run Mo workflows on a forecast or supply plan in Moselle, let a workflow edit plan values, and approve every change before it is written.

{% hint style="info" %}
**Quick Answer:** Open a forecast plan or supply plan and click **Run workflow** in the header. Pick a workflow, watch its steps complete, and approve any changes it proposes before they are written to the plan. A typical run takes a few minutes.
{% endhint %}

## What Can a Workflow Do on a Plan?

**A plan workflow is** a [Mo workflow](https://learn.moselle.io/mo/key-capabilities/mo-workflows.md) that reads a plan, works out changes, and — after you approve — writes those changes back to the plan. Mo drafts these workflows with you in chat, the same way as any other workflow.

Workflows can use three kinds of steps on a plan:

| Step                 | What it does                                                            |
| -------------------- | ----------------------------------------------------------------------- |
| **Edit forecast**    | Changes forecast values on a forecast plan                              |
| **Edit supply plan** | Changes planned order quantities and dates on a supply plan             |
| **Approve**          | Pauses the run until a person reviews and approves the proposed changes |

{% hint style="warning" %}
Running a workflow from a forecast plan's page always asks for your approval before it changes the plan.
{% endhint %}

## Prerequisites

**Time Required:** 5 minutes\
**Difficulty:** Beginner

* [ ] A forecast plan or supply plan in your account
* [ ] A saved workflow that is set up to run on a plan (ask Mo to build one — see below)

## How Do I Run a Workflow from a Plan Page?

{% stepper %}
{% step %}

### Open the plan

Go to the forecast plan or supply plan you want to change.
{% endstep %}

{% step %}

### Click Run workflow

Find **Run workflow** in the plan header. It lists the workflows that can run on a plan. If you don't see the button, no workflow is set up to run on a plan yet.
{% endstep %}

{% step %}

### Watch the steps

A progress window shows each step moving from pending to running to done, with a progress bar. You can close the window — the run keeps going and the header shows **Workflow running**.
{% endstep %}

{% step %}

### Review and approve the changes

When the workflow reaches an **Approve** step, you see its message, a summary such as how many values change and the net units, and a preview of the rows. Choose **Approve** to write the changes, or **Reject** (optionally with a reason) to stop the run.

{% hint style="success" %}
Success! Once approved, the plan refreshes with the workflow's edits.
{% endhint %}
{% endstep %}
{% endstepper %}

## How Do I Build a Workflow That Edits a Plan?

1. Open **Workflows** and start a new thread with Mo.
2. Describe the change in plain words, for example `Lower the forecast by 10% for items flagged as slow movers`.
3. Tell Mo how it should run: on a schedule, by hand on a plan you choose, or when a forecast or supply plan is built.
4. Review the draft. Mo adds an **Approve** step before every edit.
5. Choose **Save**.

Mo tests the draft on your master forecast, or on a plan you name, before you save.

## What Happens to Approvals?

* **Anyone who can see the run can approve or reject it.**
* The workflow's owner gets an email, and reminders while the run waits.
* If nobody decides within a week by default, the run is cancelled. Mo can set a different wait of up to 14 days.
* A rejected run shows a **Rejected** status in run history.

## Frequently Asked Questions

### Can a workflow change my plan without asking me?

**Answer:** No. Workflows run from a forecast plan's page always ask for approval first, and Mo adds an **Approve** step before each edit it drafts.

### Why don't I see the Run workflow button?

**Answer:** The button only appears when at least one workflow is set up to run on a plan. Ask Mo in the **Workflows** page to build one.

### Does closing the progress window stop the run?

**Answer:** No. The run continues in the background and the plan refreshes when it finishes.

### Why was my edit refused?

**Answer:** A change is refused when the values it expected no longer match the plan — for example, the plan was rebuilt or someone edited it after the workflow read it. Run the workflow again to pick up the latest values.

## Troubleshooting Common Issues

| Problem                            | Solution                                                       | Time to Fix |
| ---------------------------------- | -------------------------------------------------------------- | ----------- |
| Run is waiting and nothing happens | Open the progress window or the run page and approve or reject | 1 minute    |
| Run was cancelled                  | The approval wait expired. Run the workflow again              | 2 minutes   |
| Edit refused                       | The plan changed since the workflow read it. Run it again      | 2 minutes   |
| Plan doesn't show the changes      | Refresh the page once the run shows as done                    | 1 minute    |

## Related Guides

{% content-ref url="/pages/gSgwuWf3srKYlb1014s1" %}
[Mo Workflows & Templates](https://learn.moselle.io/mo/key-capabilities/mo-workflows.md)
{% endcontent-ref %}

{% content-ref url="/pages/IrQ4QB34u79BWouVKeAr" %}
[Schedule Work with Mo](https://learn.moselle.io/mo/key-capabilities/schedule-work-with-mo.md)
{% endcontent-ref %}
