> For the complete documentation index, see [llms.txt](https://moodboard-creations.gitbook.io/vincent-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://moodboard-creations.gitbook.io/vincent-doc/sections/subscription.md).

# Subscription

## Subscription

The **Subscription** section guides customers through choosing a recurring product, an option, a quantity, and a delivery plan. You can also ask questions to help customers find suitable products and offer extras for their first order.

Each part of the journey is a separate block, so you can customize its content and appearance in the theme editor.

***

#### Before You Start

Your subscription products must have recurring purchase plans assigned through a subscription app. The section displays the available plans; delivery schedules, recurring payments, and subscription management are handled by the app.

Start with Set Up Subscription Products if your products do not already have subscription plans.

#### Add the Subscription Section

{% hint style="info" %}
**How to add it**

1. From your Shopify admin, go to **Online Store > Themes**.
2. Open Vincent in the theme editor using **Edit theme** or **Customize**, depending on the label shown in your admin.
3. Use the page selector to open the page template where you want the subscription builder.
4. Click **Add section** and select **Subscription**.
5. Open the section settings and choose your **Subscription products**.
6. Expand the section to edit its blocks.
7. Arrange the steps as described below, then customize their content.
8. Click **Save**.

You can add one Subscription section per template. Add it to the main template area; it is not available in the header, footer, or overlay groups.
{% endhint %}

For a dedicated subscription page, create a separate page template and assign it to the intended page. Changes to a shared template affect every page using it. Refer to [Shopify’s template guide](https://help.shopify.com/en/manual/online-store/themes/theme-structure/templates) for template creation and assignment.

***

#### Section Settings

| Setting                          | What it does                                                                                                                                       |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Layout**                       | Choose **Full width** to use the available section width, or **Fit content** to follow the theme’s page container. The default is **Fit content**. |
| **Subscription products**        | Select up to 50 products to offer. Only products with an available variant and a recurring plan can appear.                                        |
| **Navigation style**             | Choose **Dots** or **Numbers** for the progress navigation. The current step also displays its name.                                               |
| **Color scheme**                 | Sets the section’s background, text, and related colours. Individual steps can override this scheme.                                               |
| **Button style**                 | Choose **Primary** or **Secondary** for the Continue and Add subscription to cart buttons. Their colours come from the active scheme.              |
| **Padding top / Padding bottom** | Adds space above and below the section, from 0–100 px. Each defaults to 30 px.                                                                     |

The Start button has its own settings inside **Start page**. Optional extra products are selected inside **Add-ons**, not in the section’s product list.

#### Arrange the Steps

Use this order for a complete subscription journey:

1. **Start page**
2. **Custom question** blocks, if needed
3. **Product**
4. **Variant**
5. **Quantity**
6. **Delivery frequency**
7. **Add-ons**, if needed
8. **Summary**

New Subscription sections include these purchase steps, a sample recipient question, and the fixed Start page and Summary blocks. Edit the sample question or remove it if you do not need it.

| Block                  | What it does                                                                                                                    |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Start page**         | Introduces the subscription and lets customers begin. It stays at the beginning of the section.                                 |
| **Custom question**    | Collects one answer per question. Answers can show follow-up questions or filter products.                                      |
| **Product**            | Displays eligible products from the section’s product list.                                                                     |
| **Variant**            | Lets customers choose an available subscription variant. It is skipped when the selected product has only one eligible variant. |
| **Quantity**           | Lets customers choose a quantity within the variant’s purchase rules.                                                           |
| **Delivery frequency** | Displays the recurring plans available for the chosen variant.                                                                  |
| **Add-ons**            | Offers optional one-time extras. It is skipped when there are no eligible extras.                                               |
| **Summary**            | Shows the selections and pricing before customers add the subscription to their cart. It stays at the end.                      |

{% hint style="info" %}
Add one of each purchase-step block. Duplicating Product, Variant, Quantity, Delivery frequency, or Add-ons does not create a second independent purchase step.

Keep **Product** and **Delivery frequency** in the flow. Include **Variant** whenever any offered product has multiple eligible variants. If **Quantity** is omitted, the selected variant’s minimum quantity is used.
{% endhint %}

Start page and Summary are fixed blocks: they cannot be dragged into a different position or added as ordinary repeatable steps. Hiding Start page begins the journey at the first available step. Hiding Summary moves the add-to-cart action to the final available step.

#### Customer Navigation

Customers select an option and click **Continue**. They can use **Back**, revisit earlier steps from the progress navigation, or use **Edit** in the summary.

**Start again** clears the current answers and selections. Changing the selected product or variant also resets the quantity and delivery-plan choice where needed.

After a successful add using the cart drawer, the builder returns to its starting point. Adding a subscription to the cart does not place an order; the customer still completes Shopify checkout.

#### Preview Your Setup

Selecting a block in the theme editor opens that step for editing. Some steps need an earlier product or variant selection before they can show choices.

Test the complete journey in the storefront preview as well as selecting individual blocks. Check both desktop and mobile layouts, and try every conditional question and product-filter combination.

***

#### Related Guides

* [Set Up Subscription Products](https://moodboard-creations.gitbook.io/vincent-doc/sections/subscription/set-up-subscription-products.md)
* [Show Questions Based on an Earlier Answer](https://moodboard-creations.gitbook.io/vincent-doc/sections/subscription/custom-questions-and-answers/show-questions-based-on-an-earlier-answer.md)
* [Filter Subscription Products by Answer](https://moodboard-creations.gitbook.io/vincent-doc/sections/subscription/custom-questions-and-answers/filter-subscription-products-by-answer.md)
* [Change Subscription Text and Translations](https://moodboard-creations.gitbook.io/vincent-doc/sections/subscription/change-subscription-text-and-translations.md)
* [Subscription Troubleshooting](https://moodboard-creations.gitbook.io/vincent-doc/sections/subscription/subscription-troubleshooting.md)
