Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

📇Subscription Programs

A Subscription Program is the heart of the Smartrr app. Subscription Programs control which products are available for subscription purchase.

What is a Subscription Program?

Subscription Plans, products, and variants are objects within a Subscription Program. You may set up one or multiple Subscription Plans per shop. The default behavior of the subscription widget is to display cards for:

  • The subscription program/s the product/variant is included in (display can be handled using CSS or JS).

  • Plus the one time purchase card.

Subscription Program's high-level chart: The subscription program packages subscription plans/selling plans and products/variants. Each subscription plan includes the billing policy, delivery frequency and discounts.

Two examples for the same store are provided below:

  • Example 1: You would like to offer a discount for customers who elect to subscribe to your product vs. make a one-time purchase.

  • Example 2: You would like to offer a variety-pack product with only a monthly subscription cadence, but the individual products within the product are available on both a bi-weekly and monthly cadence.

Both above examples are possible to execute within the same storefront by creating multiple Subscription Plans within a Subscription Program.

Creating a Subscription Program

Under Configuration in the left-hand menu, click on Subscription Programs. Click on the button Create program.

"Create program" button highlighted on the "Subscription Programs" menu in the Smartrr admin portal.
View of a blank/new subscription program.

First, add all required information to your Subscription Program:

  • Storefront label: Title of the Subscription Program on your product page, ex. “Subscribe & Save 10%”

  • Storefront option label: Cadence text to display next to plan selector on your product page, ex. “Subscribe & Save 10%'', “Deliver every”, or “Frequency”. Onsite example: Display of subscription programs listed on a product page; the product displays only subscription programs that it's included in.

  • Admin label: Optional—if you would like your Subscription Program to have a different name in your Smartrr app

Next, add all required information for each Subscription Plan within your Subscription Program:

  • Display: Label of the plan frequency selection on the product page, ex. “Every 2 Weeks”. You are able to add multiple selection options. Onsite example: Display of the frequency/selling plan dropdown selector in the subscription widget.

  • Cart & Checkout label: Label displayed alongside the product once it’s been added to cart and on the checkout page, ex. “Delivered Every 2 Weeks”. Replace with a "{{H}} " to hide this label from customers.

  • Category (Legacy): Shopify requires a category to be assigned to each Subscription Program (selling plan). We recommend always leaving this set to "Subscription".

  • Billing Schedule: Indicate the number of intervals between billings as a numerical value (ex. “2”) and the interval type (Days, Weeks, Months, or Years)

  • Discount Incentive: Percentage or fixed amount discount that a customer receives with this Subscription Plan. You can also opt to change the discount percentage after a certain number of subscription orders.

For advanced subscriptions, the following options are available for merchants on Grow and Excel plans:

Each selling plan card includes tabs for Prepaid, Max/Min and Anchor settings.
Advanced Subscription Program settings tabs
  • Prepaid: If applicable, indicate the number of intervals between billings as a numerical value (ex. “2”) and the interval type will set automatically based on the interval type in the plan's Basic details tab.

  • Max/Min: Used when you'd like a subscription to end after a certain number of billing cycles.

  • Anchor: Used to set a day on which billing interval calculations should be made.

Once all required information has been completed, click Save.

Portal Add-ons

Portal add-ons are accessible by the customer via the Account Portal. Customers can add products to their subscription orders as one-time add-ons at a discounted price.

To configure add-ons, navigate to Subscription Programs and then click on the Portal Add-ons tab.

Click on Browse to select one or multiple products/variants to be available to customers as add-ons.

Image of the "Portal Add-ons" menu page in the Smartrr admin portal.

Products that are selected here will be visible to your customers in their account here:

The products added in the "Portal Add-ons" list are shown in the Smartrr account portal, next to the "Next Order"/"Subscriptions" card.

Note: At this time, it's not possible to add different add-ons per subscription program, or to offer different discounts per product in the add-ons section. To stay up-to-date with new features we release, you can follow our changelog.

Customers can click on an dd on image from within their account to view all images and read the product's description, which pulls from Shopify.

Gif highlighting the interaction with the portal add-ons in the Smartrr account portal.

How can I add filters to add-ons?

Display of filters in the "Portal Add-ons" cart when enabled. Filters are used to categorize the products that are displayed in the "Portal Add-ons" card.

If you are a shop with a large add-on offering, it might be helpful to add filters so your customers can easily find what they're looking for. To setup a filter, go to product's page from within the Shopify Admin and create a new product tag including the Smartrr filter prefix, SmartrrFilter: (ex. SmartrrFilter:Cookie). Smartrr will pick up on these tags for applicable add-on products and will automatically create filters to include within the Add-ons section.

The "Tags" field shown on the product details page in the Shopify admin portal. To filter products in the Smartrr "Portal Add-ons" list, use the "SmartrrFilter:category" structure when adding the tag. Example: SmartrrFilter:Gluten-Free.

Subscription Benefits app block

In your Shopify theme customizer, you can add the Smartrr Subscription Beneftis app block to your product pages. This widget will allow you to elaborate to customers the benefits of subscribing and can be fully customized.

Adding the Subscription Benefits app block to a product page in the theme's Customize view.
Add the app block to the product page inside the Shopify theme customizer
Fields in the "Subscription Benefits" block's settings to add a headline and list the benefits that the subscription provides.
Customize the app block from right in the Shopify theme customizer

Last updated