View Product Page

Product page

In the section Customization, you can manage the style of subscription product pages, cart and checkout, and My account page by setting custom labels and colors that better fit your needs. You can also set the colors for the different statuses of the subscriptions.

Check the available options of the different sections:

Product page

Product page customization
  • “Add to cart” label in subscription products: Change label in shop- and product page.
  • Show trial period: Show trial period on the shop- and product page
  • Enter a text: Where {{trialtime}} is eg. ’10 days’.
  • Choose a color: Choose the color of the text.
  • Show fee information: Show sign-up fee information on the product page.
  • Enter a text: Where {{feeprice}} is eg. ‘$9,99’.
  • Choose a color: Choose the color of the text.
Product page example

Cart and checkout page

To set different texts for subscription type products in the cart and checkout pages, go to YITH > Subscription > Customization.

Cart and checkout customization
  • “Place order label” in checkout page: Text that replaces ‘place order’ for subscription type products in checkout page.
  • Free trial period text to show on cart: Where {{trialtime}} is eg. ’10 days’.
  • Show total subscription amount: Total amount of the subscription.
    • Enter a text for the subscription total: Where {{sub-time}} is eg. 8 weeks multiplied by {{sub-total}} eg. 90,00$ makes 720,00$.
  • Show next billing date: First payment date after the free trial ends.
    • Enter a label for the next billing info: Next upcoming payment date, after the initial payment date.
    • Enter a label for the next billing info in case of a trial period: Tekst for the first payment date after the free trial ends.

2 checkout examples below:

checkout examples
  • Thank you page layout: Decide how to show the subscription details on thank you page, either in a table or in a separate box.
Thank you table
Table
Thank you separate box
Separate box

These texts will only be shown on cart and checkout pages, you can set a different text for shop- and product pages as described here.

Subscription in My account page

To decide which options and texts the user will see in the My account page, go to YITH > Subscription > Customization.

Resubscribe and Renew options
  • Show the Resubscribe button on My Account > Subscriptions: Decide if you want the give the customer the option to resubscribe to the same subscription.
  • Maintain the same price of the previous subscription: Enable if you want the customer to pay the same price as before, disable to pay the actual price.
  • Show the Renew now button on My Account > Orders: Decide if user will be able to force the payment himself, if at least one failed payment attempt is registered (Note: each time the user forces a payment it counts as an attempt).
Pause and Cancel options
  • Pause/Cancel subscription style: Choose to either show the options as buttons or in a dropdown.
2 options on my account

If you choose to show the options in a dropdown, you can edit the texts as shown below.

Pause subscription text
Pause subscription text
Resume subscription text
Resume subscription text
Cancel subscription text
Cancel subscription text

If the customer chooses any of the options from the My account page (pause, resume, cancel) a popup will appear. You are able to customize the text of these popups and the buttons in YITH > Subscription > Customization. In the images below you’ll see an example of the popup and its settings.

Pause subscription

Pause modal text
Pause modal window

Resume subscription

resume text

Cancel subscription

Cancel subscription modal text
Cancel modal window

Finally, you can also customize the texts for the subscription plan switch as shown below.

Switch plan texts
My account page
Checkout page

Subscription box

If you have enabled the option ‘‘Subscription box edition” from the plugin General settings > Subscription box, the users will be able to modify the products that are part of the box.

Note: this option also depends on what timeframe has been configured on the Product edit page > Subscription options > Allow box editing up until. Visit this page for more details.

To modify the products in the box the user will need to click ”edit box” button and this will take the user to the product listing page where the products can be changed.

Once the user is done with the new products selection, a cart page will have the box resume and the option to ”save box”.

By making this change a new box will appear on my account page, this will show the products that would be delivered in the next shipment.

Just below, the page will display the billing/shipping information and details about the delivery dates, refer to this page to know more about the delivery schedules.

Subscription box

Subscription boxes are a type of service in which customers can configure several items into a single purchase and receive them on a regular basis.

To add this section to the plugin panel, you must first enable the related module going to the plugin settings> Modules.

Once this option has been enabled, a new tab will show up in the plugin general settings so we can start configuring it.

Now let’s look at the configuration of the subscription box, this part focuses on the look and feel of the page that is created by using the new product type in this module.

Subscription box settings
  • Sold individually: enable this option to allow users to add only one subscription box to the cart
  • Show site logo: enable to be able to upload the site logo at the top in the box creation page
  • “Add to cart” label in subscription box products: you can give a custom name to the “Add to cart” button label on subscription box products
  • Colors:
    • Primary/darker: change the color for the ”add to cart” label in subscription box products
    • Button background/hover: change the text color of the buttons in box creation pages
    • Button text/hover: change the color of the buttons in box creation pages
    • Footer/header Background: change the color for the footer and header background
  • Pagination: enable this option to set how many products to show (this option works with infinite scrolling pagination)

Note: if this option isn’t enable, all products will loaded immediately in each step.

Subscription box edition

Now, if you want your customers to be able to modify the products that are already part of their active subscription, enable the option ”Allow customers to edit box content”.

Users will be able to do modify the products from my account page, go to this page to know more about the options available.

Renewal synchronization

If you need to synchronize all subscription renewals to better manage and check your customers’ payments, go to the section Modules and enable Renewal synchronization.

Sync module

A new section will then show in the plugin panel from which you can configure the available options.

Signup payment options

Signup payment options
  • First payment at signup fee options: here, you can choose how to manage the first subscription payment at signup from:
    • Don’t charge the first recurring amount at signup (only a signup fee, if set): When you create a subscription product, you can choose the day on which renewals synchronize and charge the subscription payment to your users.
    • Charge a prorated payment and, therefore, when to charge the first recurring amount to your users: The user will pay a part of the recurring amount, automatically calculated based on the days left till the renewal. (Renewal day is set on the subscription product page).
      • Postpone the first payment, if the next payment is in less than: Use this option to avoid charging the user twice in quick succession if a subscription has been bought near a renewal date by setting the number of days until next renewal.
    • Charge the full recurring amount on signup: regardless of the number of days left for the next renewal date.

Please, note: if the product includes a trial period, no prorated amount will be charged, so the next payment date will be automatically set as the first renewal date.

Renewal synchronization

Renewal synchronization
  • Synchronize recurring payments for: Choose if you want to synchronize subscription payments to a specific day of the week, month, or year. For example each Monday or the first day of each month. You can do that for all products or specific products/categories. Available options:
    • All products: You will be able to exclude some products or categories if this option is selected.
    • Only virtual products: You will be able to exclude some products or categories if this option is selected.
    • Specific products: Select the products to include in the related option.
Products to include
  • Specific categories: Select the products to include in the related option.. You will be able to exclude some products if this option is selected.
  • Display recurring payments info on the product page: Enable if you want to show additional information about the synchronization on the product page.

You can continue with the settings from the product detail page (details here) where you will be able to configure the sync option based on every product billing cycle.

Please, note, the synchronization settings can only apply to new subscriptions (so subscriptions started after the settings are saved) and it does not apply to ongoing subscriptions.

Delivery schedules settings

Through the Delivery schedules settings, you will be able to schedule deliveries for those subscriptions whose renewal payment does not match the delivery date. For example, you might sell a monthly subscription to a printed magazine that is billed yearly. In this case, you will charge your users yearly, so the renewal order will be generated every one year, but you will need a tool to schedule and prepare all the monthly shipping.

To add this section to the plugin panel, you must first enable the related module from Modules.

Delivery schedule module

Let’s now analyze the available options:

Delivery schedules settings
  • Set a delivery schedule of subscription products for: select the products or categories that will be affected by the delivery schedules.
    • All products: you will be able to exclude some products or categories if this option is selected.
    • Only non-virtual products: you will be able to exclude some products or categories if this option is selected.
    • Specific products: you can select the products in the option Products to include.
    • Specific categories: you will be able to select the categories in the option Categories to include.
  • Products to exclude: enable this option if you want to exclude some products from delivery.
  • Default delivery schedule: you can choose how frequently the subscription products have to be delivered, for example, every 1st of the month or every Monday. If the product recurrence is set in days, you will not be able to set a synchronization day. If the product recurrence is set in weeks, you will be able to choose the day of the week. Please, note that if the billing cycle is 2 weeks and Monday, it will always be the first Monday every two weeks.This is a global setting that can be overridden inside the product page. If the product recurrence is set in years, you will be able to choose month and day, for example January 1st or June 30th every year.
Yearly subscription delivery schedule

These general settings will apply to your product selection, but you will be able to override this on a product or variation level. For more information see here.

All delivery schedules

If you need to charge your users annually but ship every month, setting up a different delivery schedule is the perfect option for you.

Please, make sure you have enabled the Delivery schedule module and configured the global options as described on this page and the product settings as well.

You will be able to see then the tab Delivery schedules in the plugin panel, where you can check all the next scheduled deliveries in a glance and manage them easily from this page.

All delivery schedules

From this view, you can filter them by:

  • status
  • product
  • customer 
  • date range
Filter deliveries

The list is updated daily (a daily cron is set up to update this page) based on the subscription settings.

Every delivery has a specific status:

  • In process: this is the status of all deliveries that have to be shipped today. All subscriptions will be checked daily and will appear in this list on the day they are supposed to be shipped.
    So for example, if you ship a magazine every week on Monday, every Monday you will find all waiting deliveries here, so you can process them all.
  • Waiting: this is the status of all future deliveries.
  • Shipped: the item has been shipped. Once you set the delivery to this status, an automatic email will be sent to the customers to inform them about the shipping.
  • Cancelled: the delivery of this schedule has been cancelled

So, for example, how to handle deliveries for today and prepare those for the next days?

You can start filtering the subscriptions by in process status, so you will only see those delivery entries that have to be shipped today.

Delivery schedule - filter by status

Once they are completed, you can change their status to shipped, so the customer will receive an email that informs them about the shipping.

Shipped delivery
Shipped modal

Once confirmed, the date of the shipping will be registered and shown in the Shipped on column:

Shipped on

Once you’ve finished shipping all today’s deliveries, you can start preparing those that have to be shipped tomorrow.

Filter deliveries by waiting and by date as well.

Filter deliveries by waiting status and date

You will be able to find the list of all next deliveries for a specific subscription in the subscription details, just right below the related orders box. Here you will be able to change the status of the delivery schedule and see all the next schedules as waiting.

Change delivery status

The customer will be able to see an additional box in My Account > Subscriptions > Related Delivery with a list of the delivery schedules for their subscription. Only the next 5 deliveries will be listed here:

Please note: It is only possible to choose 1 day per week/month/year. So for example, you cannot select deliveries each Monday and Wednesday.

Print shipping labels

If you sell subscription-based products that need to be shipped, you can download a list with your customers’ addresses into a PDF file and print the shipping labels in one click.

Just click on the Download shipping list button on top of the table and the plugin will generate a PDF document with the shipping labels of those deliveries with status “In process“:

Download shipping list
Downloaded shipping list

Automatic payment methods

The plugin supports several automatic payment methods, meaning that the customer gets charged automatically when each recurring payment is due.

Note: the payment method chosen during the purchase, will be the same for all periodic fees that the user will have to pay, it’s impossible to switch.

Supported gateways:

The PayPal Standard settings are explained below, if you wish to see the settings of the other payment gateways, simply click on the one you are interested in.

PayPal Standard

Preliminary note: if you’re using WooCommerce 5.5 or higher, PayPal standard will be hidden by default, but you can reactivate it as explained here.

PayPal standard supports automatic recurring payments, so users don’t have to remember to pay the recurring fee. If the owed amount is not available in the users’ PayPal account, the subscription will be cancelled or will switch to “Overdue” or “Suspended” status (depending on the settings).To let the plugin work correctly, it is necessary that your PayPal account (compulsory for any type of business) is set to receive multi-currency payments. If you haven’t set this option in your PayPal account yet, follow the guidelines described below:

  • Go to www.paypal.com/ and access to your business account;
  • Click on My Account and then on Profile;
  • Open section My Selling Tools;
  • In Getting paid and managing my risk , click on update next to the entry Block Payments
PayPal account settings
  • Set the option ‘allow payments sent to me in a currency I do not hold’ to ‘yes, accept and convert theme to U.S. Dollars
Allow multi-currency payments

Note: You can associate more than one subscription to the same user, however, users need to place separate orders for each subscription. The system used to integrate PayPal recurring payments doesn’t allow multiple subscriptions within the same order.

If you use PayPal Standard, the date for the payment cannot be edited in any way. It refers to the day when the first subscription payment occurred.

Other payment methods

You can use any payment method activated in your WooCommerce to pay for a subscription, however, if it isn’t one of the supported payment methods, the customer will have to pay the renewal order manually.

To find out which payment gateways support automatic charges, please refer to this page.

How can I pay for a renewal order if a non-supported gateway has been selected?

One day before the renewal date, a new order will be generated automatically. This order will be visible for the users in ‘My account > My Subscriptions’.

Customers can just click on the ‘Pay’ button that will redirect them to checkout page and complete the payment with any gateway.

my account pay button

Supported gateways

Here is a list of all the gateways supported by YITH Subscription plugin. You will be able to start automatic recurring payments with all of them, but the options allowed by each of them vary. You can compare them in the following table.

 Standard featuresChanges allowed
 CancellationPauseMultiple subscriptions in cartAmountPayment date
PayPal Standard
YITH WooCommerce Stripe – Premium
YITH PayPal Braintree
YITH PayPal Express Checkout*
YITH WooCommerce Stripe Connect
YITH WooCommerce Account Funds
WooCommerce Amazon Pay
WooCommerce Stripe (credit card only)
WooCommerce eWay Gateway
WooCommerce Payments
WooCommerce PayPal Payments
WooCommerce Redsys Gateway

* In order to manage recurring payments it is necessary that the reference transactions are active on your PayPal account. Verify through PayPal support if they are active before implementing the payment method.