===================================
Subscriptions in the eCommerce shop
===================================

Subscription products can be sold in the Odoo *eCommerce* shop just like regular sales products.

However, by default, the eCommerce product page **only** displays the shortest recurrence period
listed in the :guilabel:`Recurring Prices` tab of the product form.

For example, if a subscription product has *monthly* and *annaul* recurrence periods configured,
then *only* the monthly price appears on the eCommerce page for that product, by default.

To add more recurrence periods to the eCommerce product page, create a *product variant* for each
recurrence period.

.. seealso::
   - :doc:`Configure subscription products </applications/sales/subscriptions/products>`
   - :doc:`Product variants </applications/sales/sales/products_prices/products/variants>`

Create recurrence periods as product variants
=============================================

To set up each recurrence period as a product variant, go to :menuselection:`Subscriptions app -->
Products --> Products`, and select a product. In the :guilabel:`Attributes & Variants` tab, click
:guilabel:`Add a line`.

Then proceed to create an :guilabel:`Attribute` called `Billing Period` (or something similar), by
typing in the name, and clicking :guilabel:`Create` from the mini drop-down menu that appears. This
attribute name appears as option heading on the product page of the eCommerce shop.

Next, create :guilabel:`Values` that correspond to the recurrence periods that are configured in
the :guilabel:`Recurring Prices` tab of the product form.

To do that, type in the name of the recurrence period in the :guilabel:`Values` column, on the same
:guilabel:`Attribute` line, in the :guilabel:`Attributes & Variants` tab. Then, click
:guilabel:`Create` from the mini drop-down menu that appears.

These value names appear as selectable options on the product page of the eCommerce shop.

.. image:: ecommerce/recurrence-period-attributes-variants.png
   :align: center
   :alt: Recurrence periods configured as product variants in the "Attributes & Variants" tab of
         the product form.

With those configurations in place and saved, a :guilabel:`Product Variants` column appears in the
:guilabel:`Recurring Prices` tab. Proceed to assign the different :guilabel:`Product Variants` to
their corresponding recurrence :guilabel:`Period` and :guilabel:`Price`.

.. image:: ecommerce/product-variants-time-based-pricing.png
   :align: center
   :alt: Product variants on the "Time-based pricing" tab of the product form.

After following those aforementioned steps, the product variants are available for selection on the
eCommerce product page.

.. image:: ecommerce/recurrence-period-ecommerce.png
   :align: center
   :alt: Recurrence periods configured as product variants on the eCommerce product page.