Skip to main content

Subscriptions

Starting in version 4.0, ShopWP now integrates with Recharge to provide support for subscription products. This allows you to display and sell subscriptions like you would on a Shopify theme.

Getting started

Before you can start showing your subscription products, there are a couple steps you must take.

First, you must meet the below requirements and install both ShopWP Pro and the ShopWP Pro Recharge extension. You also need to have the Recharge Shopify app installed. Once you have these requirements met, skip to the section "Adding the Recharge API key" to finish.

Requirements

  1. ShopWP Pro
  2. ShopWP Pro Recharge Extension
  3. Recharge Shopify app installed and configured
  4. Your Recharge API key added to the ShopWP settings

Adding the Recharge API key

  1. First, open the Apps page within your Shopify store and click the Recharge app.

Finding the Recharge app

  1. Once the next page loads, click the Integrations link found in the top nav bar.

Finding the Recharge app

  1. Next, click the API tokens... link on the right-hand side of the page.

Finding the Recharge app

  1. You may need to agree to the Recharge terms of service if this is your first time using their API. Click all the checkboxes and then click Accept.

Finding the Recharge app

  1. Click the Create an API token button on the right-hand side of the page.

Finding the Recharge app

  1. Give your token a name. This can be anything you want, but something to easily identify your site would be useful such as your wordpress domain. Next, add your contact email address (probably the same as your WordPress user email). For the permissions, set the Subscriptions and Products to read and write. Finally, click the terms of service checkbox and save.

Finding the Recharge app

  1. You should then be shown a confirmation notice with your newly generated API token displayed.

Finding the Recharge app

  1. The last step is to copy the API token and paste it into the plugin settings under the "Subscriptions" section. Click save to finish. You're now ready to start displaying your subscriptions.

Finding the Recharge app

Displaying the Subscriptions widget

By default, the subscriptions widget won't show with your products. The feature is "opt-in" only, meaning you'll need to manually enable it on each shortcode or block. You can also choose to enable subscriptions globally for all products.

Showing subscriptions with shortcodes

To show subscriptions with a shortcode, add the subscriptions attribute with the value true. It should look like this:

[wps_products subscriptions="true"]
info

For more information on the available shortcode attributes, reference the subscriptions section.

Show subscriptions globally

To show the subscriptions for all products, you'll need to enable the Show subscriptions by default setting. To do this, open the plugin settings and find the Subscriptions section. Once open, turn on Show subscriptions by default and click save.

Finding the Recharge app

How the checkout process works

One of the coolest aspects of the subscriptions feature is the seamless integration with Shopify checkout.

Traditionally, Shopify subscription products required developers to create their own checkout pages. This was cumbersome for many reasons. Thankfully, we're now able to use the same checkout page that your customers are used to. This also means that you should be able to continue using any third-party Shopify apps that may customize the checkout experience.

The checkout process will work the same way is does with non-subscription products. In fact, your customers can even add subscription and non-subscription products to the same cart, and purchase them together.

Additional questions

If you have additional question or need extra support, make a comment in the Slack channel or send us an email: hello@wpshop.io