Using custom line item properties

Learn how you can include custom line item properties in orders.

When a Recharge product is added to the cart, line item properties that define the subscription product and subscription interval are sent along with the product data. You can specify custom line item properties that will be included in the order.



  • Recharge Checkout on Shopify

Line item property variables

shipping_interval_frequency (required)Numeric value (eg. 1, 2, 3, etc.)
shipping_interval_unit_type (required)Day


charge_interval_frequencyNumeric value (eg. 1, 2, 3, etc.)


first_recurring_charge_delayNumeric value (eg. 1, 2, 3, etc.)
number_charges_until_expirationNumeric value (eg. 1, 2, 3, etc.)
charge_on_day_of_monthNumeric value (eg. 1, 2, 3, etc.)
charge_on_day_of_week0 - Monday

1 - Tuesday

2 - Wednesday

3 - Thursday

4 - Friday

5 - Saturday

6 - Sunday



The first_recurring_charge_delay property affects the time period between the first charge and the subsequent second charge. It does not impact the timing of the first charge. The first charge always occurs at the time of checkout.

Pass the properties as a form submit

Below is an incomplete form for adding an item to the cart to demonstrate how the properties must be passed.

<form action="/cart/add" method="post">
  <input name="properties[shipping_interval_frequency]" type="hidden" value="1" />
  <input name="properties[shipping_interval_unit_type]" type="hidden" value="Month" />

Pass properties via AJAX

For more information on using AJAX to add a product to the cart, visit Add an item to the cart with Ajax. This guide is a good starting point for adding additional parameters to the cart.

Need Help? Contact Us