1. Documentation /
  2. Buy Once or Subscribe for WooCommerce Subscriptions 

Buy Once or Subscribe for WooCommerce Subscriptions 

Buy Once or Subscribe for WooCommerce Subscriptions is an extension that requires the subscription functionality to be enabled on your store. To do that you can:


↑ Back to top

With Buy Once or Subscribe for WooCommerce Subscriptions, you allow your customers to purchase a simple or variable product as a one-time buy or on a subscription basis on the same product page. The plugin will allow you to:

  • Configure subscription frequencies for simple and variable products.
  • Set discounts for each subscription frequency created


↑ Back to top

Buy Once or Subscribe for WooCommerce Subscriptions has been tested to work with the following extensions which are officially supported:


↑ Back to top

Buy Once or Subscribe for WooCommerce Subscriptions requires:

  1. WooCommerce Subscriptions 4.0.0+.
  2. WooCommerce 6.8+.
  3. Buy Once or Subscribe for WooCommerce Subscriptions plugin only supports HTTPS websites and will not work on HTTP websites.


↑ Back to top

As with any WordPress plugin, Buy Once or Subscribe for WooCommerce Subscriptions can be installed on the website in 2 ways:

  • Installing Buy Once or Subscribe for WooCommerce Subscriptions directly from your website:
    • Go to: WordPress Admin > Plugins > Add New and Upload Plugin with the file you downloaded with Choose File.
    • Click Install Now and Activate the extension.
  • Installing Buy Once or Subscribe for WooCommerce Subscriptions using FTP
    • Extract the WordPress plugin ZIP file to a folder on your computer.
    • Upload the plugin folder to your FTP server. The folder should be copied to the following WordPress folder wp-content –> plugins. If you are upgrading an existing plugin, please make sure to overwrite the existing plugin folder.
    • Activate the plugin by logging into your WordPress backend. Go to Plugins –> Installed Plugins, find the plugin from the list and click ‘Activate’.

More information at Install and Activate Plugins/Extensions.

Setup and Configuration

↑ Back to top

To define subscription frequencies for a product you have to:

  1. Add a new Simple or Variable WooCommerce Product or you can also edit an existing one.
  2. Go to Product Data > Subscriptions tab.
  3. Enter a Title for your Call To Action, e.g. “Choose subscription frequency”. This is optional and if you leave this blank, the default text “Choose Frequency” title will be used.
  4. Click on Add Frequency to add a subscription plan:
    1. Choose the frequency. You can combine every, 2nd, 3rd, 4th, 5th and 6th with day, week, month or year.
    2. Optionally, add a percentage discount, e.g. 10 (without the % symbol). If you leave this field blank or set it to 0 then no discount will be applied for that subscription plan.
  5. You can add as many subscription plans as you like. The plans can be ordered and deleted, and this will be reflected in the way the plans will be displayed on the product page.
  6. When you are done adding all the frequencies, Publish or Update the product to save the changes.

Have a question before you buy? Please fill out this pre-sales form.

On the product page, the customers will be able to choose between a one-time purchase and a subscription. If a product has more subscription plans defined then the customer will be able to choose the desired plan from a dropdown list. 

When the subscription option is selected, the Add to cart button text will change to “Sign up now” (if you are using the subscription functionality from WooCommerce Payments) or to the text set in the Add to Cart Button Text field from WooComerce – Settings – Subscriptions (if you are using WooCommerce Subscriptions)

Product page

Once a product has been purchased on a subscription plan, a WooCommerce subscription will be created for that product. 

If an order contains products with different subscription frequencies, then the products will be grouped according to their subscription frequency and a subscription will be created for each frequency. On the cart and checkout page, the Subtotals and recurring totals will be calculated for each subscription frequency.

Custom add-to-cart links

↑ Back to top

In order to add a product to the cart as a subscription using a custom add-to-cart link you will need to know the product ID (and variation ID in case of variable products) for the product you want to add to the cart. The link will have the following structure:

https://domain.com/?add-to-cart={Product ID}&variation_id={Variation ID}&bos4w-purchase-type=1&convert_to_sub_plan_{Product ID}={Subscription interval}_{Subscription period}_{Discount}

An example of a custom add-to-cart link is:


The subscription period and subscription interval are the ones used by WooCommerce Subscriptions. In case the combination between the subscription period, subscription interval and discount is not matched with any of the frequencies and discounts set on the product, the product will be added to the cart at full price and without a subscription frequency (as a simple or variable product).


↑ Back to top

Sign-Up Fees

↑ Back to top

New subscription plans generated with Buy Once or Subscribe for WooCommerce Subscriptions do not support sign-up fees. Please let us know if this is something you need and we’ll look into it. 

Adding prorated products/carts to subscriptions

↑ Back to top

It will not be possible to add a prorated and synchronized product/cart to an existing subscription. Please let us know if this is something you need and we’ll look into it. 

Developer Hooks & Filters

↑ Back to top

Please check this document for all Buy once or Subscribe for WooCommerce Subscription hooks and filters.

Feedback and Suggestions

↑ Back to top

If you’d like to add a feature to Buy Once or Subscribe for WooCommerce Subscriptions that you think would be useful, we’d love to hear about it!

Please send your suggestion to our support team and we’ll consider adding it in the future. 

Questions & Support 

Purchased Buy Once or Subscribe for WooCommerce Subscriptions and need assistance? If you’ve found an issue:

  1. Ensure you have the latest versions of WordPress, WooCommerce and WooCommerce Subscriptions.
  2. Go to WooCommerce > System Status to check for plugin updates and other important information that may require your attention.
  3. Rule out a plugin conflict: Turn off all plugins except WooCommerce, WooCommerce Subscriptions or WooCommerce Payments and Buy Once or Subscribe for WooCommerce Subscriptions. If the issue is resolved, find the plugin that triggers the issue by re-activating plugins one by one.
  4. Rule out a theme conflict. Activate Storefront, or a default WordPress theme such as Twenty Fourteen and check if the issue still occurs. If it doesn’t, please contact your theme author(s).
  5. Read the most Frequently Asked Questions.
  6. Read these important notes on Compatibility.
  7. Use the WooCommerce Self Service Guide.

If you followed these steps but the issue persists, get in touch with us via the Help Desk!


The most customizable ecommerce platform for building your online business.

  • 30-day money-back guarantee
  • Support teams across the world
  • Safe and secure online payment