{"title":"Promotion - Liquid Object Reference","slug":"promotion-liquid-object-reference","url":"https://support.storeconnect.com/articles/promotion-liquid-object-reference","url_markdown":"https://support.storeconnect.com/articles/promotion-liquid-object-reference.md","subtitle":null,"summary":"The Promotion object contains information about a promotion that can be applied to an Order","type":"Developer_Documentation","video_url":"","keywords":"liquid, objects, Promotion, template, storeconnect","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Description\n\nThe Promotion object contains information about a promotion that can be applied to an Order\n\n:::note\nThis object supports custom data via the `data` attribute.\n:::\n\n## Attributes\n\n| Attribute | Type | Description |\n|-----------|------|-------------|\n| `actions` | List[[PromotionAction](promotion-action-liquid-object-reference)] | Returns a list of PromotionAction objects associated with this Promotion |\n| `campaign` | [Campaign](campaign-liquid-object-reference) | Returns the Campaign object associated with this Promotion |\n| `code` | String | Returns the code that can be used to apply this Promotion |\n| `expires_at` | Timestamp | Returns the timestamp when this Promotion ends |\n| `id` | String | Returns the unique id for this Promotion |\n| `name` | String | Returns the name of this Promotion |\n| `scopes` | List[[PromotionScope](promotion-scope-liquid-object-reference)] | Returns a list of PromotionScope objects associated with this Promotion |\n| `starts_at` | Timestamp | Returns the timestamp when this Promotion starts |\n| `usage_count` | Number | Returns the number of times this Promotion has been used |\n| `usage_limit` | Number | Returns the maximum number of times this Promotion can be used |\n| `valid?` | Boolean | Returns whether this Promotion is active (within the start and expiry dates and not over the usage limit) |\n\n## Available on\n\n- [Cart - Liquid Object Reference](cart-liquid-object-reference) — `promotions`\n- [PromotionAction - Liquid Object Reference](promotion-action-liquid-object-reference) — `promotion`\n- [PromotionScope - Liquid Object Reference](promotion-scope-liquid-object-reference) — `promotion`"}