# Subscription - Liquid Object Reference

Source: https://support.storeconnect.com/articles/subscription-liquid-object-reference · Last modified 21 August 2026

## Description

The Subscription object represents a subscription order for a customer.

:::note
This object supports custom data via the `data` attribute.
:::

## Attributes

| Attribute | Type | Description |
|-----------|------|-------------|
| `can_pay_now?` | Boolean | Returns true if the Subscription has payment due and can be paid now |
| `can_update_payment_source?` | Boolean | Returns true if the customer is allowed to update Subscription's payment details |
| `cancellable?` | Boolean | Returns true if the customer is allowed to cancel this Subscription |
| `cancelled_date` | Timestamp | Returns the date this Subscription was cancelled |
| `contact` | [Contact](contact-liquid-object-reference) | Returns the Contact associated with this Subscription |
| `end_date` | Timestamp | Returns the date this Subscription ends. The Subscription stops being processed once this date passes |
| `has_saved_payment_details?` | Boolean | Returns true if the Subscription has saved payment token and provider |
| `id` | String | Returns the unique id for this Subscription |
| `new_payment_path` | String | Returns the url path for the payment form |
| `next_due_date` | Timestamp | Returns the date this Subscription is next due to be charged |
| `order` | [Order](order-liquid-object-reference) | Returns the Order associated with this Subscription |
| `path` | String | Returns the url path for this Subscription |
| `payment_method` | String | Returns the payment method used for this Subscription |
| `payment_overdue?` | Boolean | Returns true if payment is overdue (billing date in the past) |
| `payment_path` | String | Returns the url path for submitting payment |
| `payment_provider` | [PaymentProvider](payment-provider-liquid-object-reference) | Returns the PaymentProvider associated with this Subscription |
| `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 |
| `payment_source_identifier` | String | Returns the identiifer for this Subscription payment source |
| `payments` | PaginatedList[[Payment](payment-liquid-object-reference)] | Returns a list of Payments for this Subscription |
| `price` | Number | Returns the price of this Subscription |
| `product` | [Product](product-liquid-object-reference) | Returns the Product associated with this Subscription |
| `renewal_date` | Timestamp | Returns the date this Subscription is due to renew |
| `renewal_order` | [Order](order-liquid-object-reference) | Returns the Order associated with the next renewal of this Subscription |
| `renewal_order_date` | Timestamp | Returns the date when the new Order for the next renewal will be generated |
| `start_date` | Timestamp | Returns the date this Subscription began |
| `status` | String | Returns the current status of this Subscription |
| `suspended_date` | Timestamp | Returns the date this Subscription was suspended |
| `total_payable_amount` | Number | Returns the total amount payable for this Subscription |
| `type` | String | Returns the type of this Subscription: evergreen, or fixed |
| `url` | String | Returns the complete url for this Subscription |

## Available on

- [Contact - Liquid Object Reference](contact-liquid-object-reference) — `subscriptions`
- [Global - Liquid Object Reference](global-liquid-object-reference) — `current_subscription`
- [Order - Liquid Object Reference](order-liquid-object-reference) — `subscriptions`
- [OrderItem - Liquid Object Reference](order-item-liquid-object-reference) — `subscription`

---

## Follow StoreConnect

- [Email Newsletter](https://getstoreconnect.com/c/lp-newsletter)
- [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464)
- [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g)
- [LinkedIn](https://www.linkedin.com/company/storeconnect)
- [X / Twitter](https://x.com/storeconnecthq)

## Popular Links

- [Partners](https://getstoreconnect.com/partners)
- [News](https://getstoreconnect.com/articles/news)
- [Events](https://getstoreconnect.com/articles/events)
- [Feature Comparison](https://getstoreconnect.com/how-we-compare)
- [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT)
- [Book a Demo](https://getstoreconnect.com/contact)

## Documentation

- [Help documentation](https://support.storeconnect.com/help-documentation)
- [AI agents](https://support.storeconnect.com/ai)
- [Videos & tutorials](https://support.storeconnect.com/videos-tutorials)
- [Developer reference](https://support.storeconnect.com/developer-reference)
- [Release notes](https://support.storeconnect.com/release-notes)
- [Troubleshooting](https://support.storeconnect.com/troubleshooting)
- [Trust Center](https://trust.getstoreconnect.com/)
- [Status Page](https://status.storeconnect.com/)

## Contact

- info@getstoreconnect.com
- US +1 415 745 3230
- AUS +61 2 8365 2308

100 S Ashley Dr, Suite 600-2461
Tampa FL 33602-600 USA

Level 22, Sydney Place
180 George Street
Sydney, NSW, 2000, AUS

---

StoreConnect Support — https://support.storeconnect.com/articles/subscription-liquid-object-reference