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

# Understanding Campaigns, Versions and Promotions

> How campaigns, versions and promotions relate, the statuses a version moves through, and how to switch between them.

The Campaigns area is built around three ideas: the **campaign**, the **versions** inside it, and **promotions** as a special kind of version. Understanding how they nest makes everything else easier.

## The Hierarchy

* **Campaign**. The top-level container for a referral programme in a single locale (language and region). A campaign holds many versions, but only one is live at any time.
* **Version**. A single iteration of the campaign that you build on the canvas. You create versions, edit them as drafts, and roll them out over time. Each version contains the offers, rewards, sharing and journey for that iteration.
* **Promotion**. A version that runs only between set dates. It is still a version; it just carries a start date, an end date, and a last date for friends to qualify.

A campaign therefore looks like a stack of versions: one live, perhaps one or more queued to follow, several drafts in progress, and a history of past versions.

## Campaign Status

A campaign itself has three statuses, shown as a pill on the campaigns list:

| Status     | Meaning                                                                                    |
| ---------- | ------------------------------------------------------------------------------------------ |
| **Draft**  | Not yet launched. No version has gone live.                                                |
| **Live**   | The campaign has been launched and has a running version.                                  |
| **Paused** | Promotion is stopped. Existing share links still work, but no new customers see the offer. |

You pause and resume a campaign from the **Settings** menu in the editor. See [campaign settings and gaming control](/knowledge-v2/referral/campaigns/manage/settings-and-gaming-control).

## Version Status

A version moves through its own statuses as you roll it out. These appear in the **version picker** with a coloured dot:

| Status               | What it means                                                          | How a version gets here                                      |
| -------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------ |
| **Draft**            | A work-in-progress version you can edit.                               | Created new, duplicated, or started from a previous version. |
| **Queued** (Up next) | Scheduled to go live after the current live version, or at a set date. | Launched with a "queue" or "schedule" option.                |
| **Live**             | Currently serving customers.                                           | Launched now, or a queued version's start date arrives.      |
| **Paused**           | Was live, but the campaign is now paused.                              | The campaign is paused while this version is live.           |
| **Past**             | Has finished running.                                                  | Replaced by another version, or its promotion ended.         |

## Standard Versions versus Promotions

|                   | Standard version             | Promotion                                  |
| ----------------- | ---------------------------- | ------------------------------------------ |
| **Runs**          | Indefinitely, until replaced | Only between set dates                     |
| **Dates**         | None required                | Start, end, and last-referee-purchase date |
| **A/B test**      | Can run one                  | Cannot run one                             |
| **Label**         | None                         | "Time limited"                             |
| **After it ends** | Stays live until replaced    | Can queue a follow-on to keep promoting    |

A promotion's **last referee purchase date** is the cut-off for friends to complete a qualifying action and still count towards the promotion. While a promotion is live you can push its dates out with **Extend promotion**.

## Switching Between Versions

The **version picker** at the top of the editor is how you move around a campaign's versions. Open it to see them grouped by status.

<Frame caption="The version picker, grouped by status with the launch order shown.">
  <img src="https://mintcdn.com/mentionme/SiHWD8MQ99h6hkpJ/images/knowledge-v2/campaigns/model/version-picker.png?fit=max&auto=format&n=SiHWD8MQ99h6hkpJ&q=85&s=a64bafe0e405cec034cd32d4981c39d5" alt="The version picker showing Live, Up next, Drafts and Past sections" width="876" height="866" data-path="images/knowledge-v2/campaigns/model/version-picker.png" />
</Frame>

* **Open a version**. Click any version in the picker to open it in the editor.
* **Live and Up next** are shown as a timeline, so you can see what is running now and what follows.
* **Create a new version**. Click **New version**, then **Standard version** or **A/B test**.
* **Rename or duplicate**. Use the actions menu on a version row.
* **Cancel a scheduled launch**. Use **Cancel schedule** on a queued version to take it out of the launch order.
* **Delete a draft**. Use **Delete** on a draft you no longer need.

To take a draft live, queue it, or schedule it, see [launch a campaign and version](/knowledge-v2/referral/campaigns/manage/launch-a-version).

## Why Some Versions Can't Be Edited

Only a draft of a campaign that has not yet launched is fully editable. Live, queued, paused and past versions are read-only, so the canvas shows what customers experienced without risk of accidental change. The Trigger section behaves differently again, because it is shared across the whole campaign. For the full rules, see [what you can and can't edit](/knowledge-v2/referral/campaigns/manage/the-campaign-editor#what-you-can-and-cannot-edit).

## See Also

<CardGroup cols={2}>
  <Card title="The campaign editor" icon="diagram-project" href="/knowledge-v2/referral/campaigns/manage/the-campaign-editor">
    The campaign editor.
  </Card>

  <Card title="Set up a version" icon="wrench" href="/knowledge-v2/referral/campaigns/manage/set-up-a-version">
    Set up a version.
  </Card>
</CardGroup>
