Documentation
Feedback
Guides
API Reference

Guides
Getting started
Subscriptions

Help us improve our documentation! Tell us about your experience with this article by filling out this form.

Subscriptions is the VTEX solution for customers to make recurrent purchases on a regular schedule, determining the orders’ products and frequency. This overview article presents what you can accomplish with Subscriptions and gathers relevant documentation on the subject.

Understanding Subscriptions

Subscriptions is an app developed by VTEX to facilitate recurring sales for a store. It works as an automatic scheduler, executing a repurchase at the frequency requested by the customer.

To enable Subscriptions for customers, merchants have to create subscription plans to associate the products valid for subscriptions and the frequencies available for recurrent orders.

Once the Subscriptions module is configured, the merchant can generate, edit and manage customers’ recurrent orders, and create subscription promotions.

The composition of a subscription is as the following:

{"base64":"  ","img":{"width":1361,"height":694,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":48049,"url":"https://raw.githubusercontent.com/vtexdocs/dev-portal-content/main/docs/guides/Subscriptions/subscriptions-v3-migration-guide-2_51.PNG"}}

Every subscription order has an execution count called cycle. The cycle determines the position of an order counting from when the shopper subscribed. The original order that creates the subscription corresponds to 0, the first subscription order corresponds to 1, the second corresponds to 2, and so on.

Customers can create a subscription during checkout or on their My Account page, and the communication between merchants and customers regarding subscriptions is made in the Email Templates module through transactional emails.

This module may process personal or sensitive information. Learn more about how VTEX handles data privacy at our Data privacy guide.

Setting up Subscriptions (mandatory)

To install the Subscriptions module, merchants have to contact our Support. After that, they have to follow the configuration steps described in How to configure Subscriptions in your store.

After the installation, merchants have to create subscription plans to associate the products valid for subscriptions and the frequencies available for recurrent orders.

We highly recommend creating subscription plans in the Subscriptions module of your VTEX Admin, although it is also possible to create them as catalog attachments.

Managing Subscriptions

In this section, you will find content about controlling and editing the Subscriptions settings of your store, and about updating, retrieving data and removing subscription orders.

Settings

You can edit the Subscriptions settings of your store and retrieve information about them.

Plans

It is possible to list and retrieve information about Subscription plans.

Subscriptions

You can update settings, edit items and retrieve information about a given subscription.

Cycles

Cycles are the execution count of subscription orders. The cycle determines the position of an order counting from when the customer subscribed.

You can retrieve information about cycles and rerun cycles that present errors, which will reprocess the order.

Communication

The communication between stores and customers about subscription orders happens via transactional emails. It is possible to retrieve the conversation messages sent to a customer regarding a subscription order.

Enabling manual prices

When using Subscriptions, merchants might need to configure prices manually. By enabling the Manual Price feature for Subscriptions, merchants can apply a manual price on each subscription item, overriding the current price, and maintain the same manual price for future recurrent orders from a given subscription.

Simulating prices

It is possible to simulate a subscription order price at checkout, getting information about items and shipping costs.

Configuring pickup points for subscription orders

The feature pickup points for subscription orders is in beta and available only for stores using the Checkout V6.

A pickup point is a physical location where customers can pick up their orders instead of having them delivered to their addresses, and merchants can configure pickup points for subscription orders. The requirements are the following:

  • Have the Subscriptions module installed.
  • Have pickup points configured.
  • Associate to pickup points for subscriptions orders only carriers that do not have a delivery windows configured.
  • Have items count in inventory at the subscription cycle date.

Controlling reports

You can generate reports about subscription orders using templates to filter orders. When you create a template, you determine which criteria will be used for filtering: order status, creation date, scheduled date, among others.

Contributors
4
Photo of the contributor
Photo of the contributor
Photo of the contributor
Photo of the contributor
+ 4 contributors
Was this helpful?
Yes
No
Suggest edits (Github)
Contributors
4
Photo of the contributor
Photo of the contributor
Photo of the contributor
Photo of the contributor
+ 4 contributors
On this page