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

# Managing Versions

> Create, configure, duplicate and retire versions in the Admin: the Versions list, the four tabs of a version, and the rules for the active and default switches

A [Version](/ollie-shop/concepts/version.md) is a complete checkout configuration: template, flags, props, theme, messages, and the components and functions deployed to it. This page is the reference for the **Versions** area of the Admin. The concepts page explains why you would want more than one.

## The versions list

![Versions list](https://mintcdn.com/ollie/ZKpSeyUd64Smy50J/images/admin-versions-list.png?fit=max\&auto=format\&n=ZKpSeyUd64Smy50J\&q=85\&s=ea04f4061c8407222100dbc171b7db74)

Versions: one card per version, with the actions menu open

Open **Versions** in the store sidebar. Each card shows the name, when it was last updated, and three badges: **Default** (only on the default version), **Active** or **Inactive**, and the template. Click a card to open the version.

Every store needs exactly one version that is both **active** and **default**: that is the one shoppers get, and the checkout needs it to render.

## Creating a version

![Create Version form](https://mintcdn.com/ollie/ZKpSeyUd64Smy50J/images/admin-version-new.png?fit=max\&auto=format\&n=ZKpSeyUd64Smy50J\&q=85\&s=f620416507676e7c3e63442e8d72133d)

**Create Version** asks for a **Name**, a **Template** (**Default**, **Grocery** or **Sales**, see [Templates](/ollie-shop/concepts/templates.md)) and whether it starts **Active**. A new version is never the default; you promote it later from its General Configuration tab.

The template also selects which set of default texts the checkout loads, so switching templates can change wording you overrode in the Messages tab.

## Duplicating a version

Open the card's actions menu and choose **Duplicate**. The copy is named `<name> (copy)`, is created **inactive** and not default, and carries over the template, theme, props, messages, and every component and function of the source. Components reuse the builds already deployed, so nothing is rebuilt. The live storefront is not affected until you activate the copy.

This is the fastest way to branch an experiment off the version in production.

## The version page

![Version General Configuration tab](https://mintcdn.com/ollie/ZKpSeyUd64Smy50J/images/admin-version-general.png?fit=max\&auto=format\&n=ZKpSeyUd64Smy50J\&q=85\&s=1ee0910182e5fd6775390428807f5df0)

A version: four tabs, the version id with a copy button, and View version

**View version** opens the checkout on this version in a new tab. It only works for an **active** version; an inactive one falls back to the store's default.

The **ID** next to the name is the version id the CLI accepts in `ollie.json` and `create-ollie-shop --version-id`, and the value of the `?version_id=` query parameter.

### General Configuration

| Section | What it sets |
| - | - |
| **Version Name**, **Template** | The name shown in the Admin and the template. The template cannot be cleared once set. |
| **Version Control** | **Active**: whether the version can be served at all. **Default Version**: the version the store serves when no version is requested. |
| **Authentication** | The guest and login flags. See [Ollie Login](/ollie-shop/configuration/ollie-login.md). |
| **Shipping Modes** | **Delivery** (on by default), **Pickup** (on by default) and **Custom Shipping** (off by default): which shipping options the checkout offers. |
| **Integrations** | GTM, Google Maps and PayPal. See [Integrations](/ollie-shop/configuration/integrations.md). |
| **Danger Zone** | **Delete Version**. |

Changes are saved with the **Save** button at the bottom. Only the fields of this tab are written; the Props, Theme and Messages tabs keep their values.

> [!WARNING]
>
> **Only one version can be the default.** To move the default to another version, first turn **Default Version** off on the current default and save, then turn it on for the new one and save. The save is refused while another version is still the default.
>
> Keep exactly one active default version at all times; the checkout needs it to render.

### Props Configuration

Custom props (steps, font, form config, your own keys) and the flag groups. See [Checkout Flags](/ollie-shop/configuration/feature-flags.md), [Extra Checkout Steps](/ollie-shop/customization/steps.md), [Fonts](/ollie-shop/configuration/font.md) and [Form Fields](/ollie-shop/configuration/form-fields.md). The tab has a **UI** view and a **JSON** view; both save with **Save Changes**.

![Version Props Configuration tab](https://mintcdn.com/ollie/ZKpSeyUd64Smy50J/images/admin-version-props.png?fit=max\&auto=format\&n=ZKpSeyUd64Smy50J\&q=85\&s=47b1b4489ee4d928872f5b209758ef37)

### Theme Configuration

The design tokens of the version. See [Theme Design Tokens](/ollie-shop/configuration/theme.md).

### Messages Configuration

Text overrides and translations. See [Translations](/ollie-shop/configuration/translation.md).

## Deleting a version

**Delete Version** in the Danger Zone removes the version and, with it, every component and function deployed to it. It asks for confirmation and cannot be undone. Only organization owners and admins can delete versions.

## Related

* [Versions](/ollie-shop/concepts/version.md): the concept, and how to open a specific version with `?version_id=`
* [Managing Components in the Admin](/ollie-shop/customization/managing-components.md): the records that live inside a version


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.