{"title":"Subscription - Liquid Object Reference","slug":"subscription-liquid-object-reference","url":"https://support.storeconnect.com/articles/subscription-liquid-object-reference","url_markdown":"https://support.storeconnect.com/articles/subscription-liquid-object-reference.md","subtitle":null,"summary":"The Subscription object represents a subscription order for a customer.","type":"Developer_Documentation","video_url":"","keywords":"liquid, objects, Subscription, template, storeconnect","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Description\n\nThe Subscription object represents a subscription order for a customer.\n\n:::note\nThis object supports custom data via the `data` attribute.\n:::\n\n## Attributes\n\n| Attribute | Type | Description |\n|-----------|------|-------------|\n| `can_pay_now?` | Boolean | Returns true if the Subscription has payment due and can be paid now |\n| `can_update_payment_source?` | Boolean | Returns true if the customer is allowed to update Subscription's payment details |\n| `cancellable?` | Boolean | Returns true if the customer is allowed to cancel this Subscription |\n| `cancelled_date` | Timestamp | Returns the date this Subscription was cancelled |\n| `contact` | [Contact](contact-liquid-object-reference) | Returns the Contact associated with this Subscription |\n| `end_date` | Timestamp | Returns the date this Subscription ends. The Subscription stops being processed once this date passes |\n| `has_saved_payment_details?` | Boolean | Returns true if the Subscription has saved payment token and provider |\n| `id` | String | Returns the unique id for this Subscription |\n| `new_payment_path` | String | Returns the url path for the payment form |\n| `next_due_date` | Timestamp | Returns the date this Subscription is next due to be charged |\n| `order` | [Order](order-liquid-object-reference) | Returns the Order associated with this Subscription |\n| `path` | String | Returns the url path for this Subscription |\n| `payment_method` | String | Returns the payment method used for this Subscription |\n| `payment_overdue?` | Boolean | Returns true if payment is overdue (billing date in the past) |\n| `payment_path` | String | Returns the url path for submitting payment |\n| `payment_provider` | [PaymentProvider](payment-provider-liquid-object-reference) | Returns the PaymentProvider associated with this Subscription |\n| `payment_source_expires_at` | Timestamp | Returns the date this Subscription's payment source is due to expire - this is normally the associated credit card expiry |\n| `payment_source_identifier` | String | Returns the identiifer for this Subscription payment source |\n| `payments` | PaginatedList[[Payment](payment-liquid-object-reference)] | Returns a list of Payments for this Subscription |\n| `price` | Number | Returns the price of this Subscription |\n| `product` | [Product](product-liquid-object-reference) | Returns the Product associated with this Subscription |\n| `renewal_date` | Timestamp | Returns the date this Subscription is due to renew |\n| `renewal_order` | [Order](order-liquid-object-reference) | Returns the Order associated with the next renewal of this Subscription |\n| `renewal_order_date` | Timestamp | Returns the date when the new Order for the next renewal will be generated |\n| `start_date` | Timestamp | Returns the date this Subscription began |\n| `status` | String | Returns the current status of this Subscription |\n| `suspended_date` | Timestamp | Returns the date this Subscription was suspended |\n| `total_payable_amount` | Number | Returns the total amount payable for this Subscription |\n| `type` | String | Returns the type of this Subscription: evergreen, or fixed |\n| `url` | String | Returns the complete url for this Subscription |\n\n## Available on\n\n- [Contact - Liquid Object Reference](contact-liquid-object-reference) — `subscriptions`\n- [Global - Liquid Object Reference](global-liquid-object-reference) — `current_subscription`\n- [Order - Liquid Object Reference](order-liquid-object-reference) — `subscriptions`\n- [OrderItem - Liquid Object Reference](order-item-liquid-object-reference) — `subscription`"}