{"title":"PromotionAction - Liquid Object Reference","slug":"promotion-action-liquid-object-reference","url":"https://support.storeconnect.com/articles/promotion-action-liquid-object-reference","url_markdown":"https://support.storeconnect.com/articles/promotion-action-liquid-object-reference.md","subtitle":null,"summary":"The PromotionAction object contains information about how a Promotion acts when it is applied.","type":"Developer_Documentation","video_url":"","keywords":"liquid, objects, PromotionAction, template, storeconnect","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Description\n\nThe PromotionAction object contains information about how a Promotion acts when it is applied.\n\n:::note\nThis object supports custom data via the `data` attribute.\n:::\n\n## Attributes\n\n| Attribute | Type | Description |\n|-----------|------|-------------|\n| `action` | String | Returns the action that this PromotionAction will take, eg: 'apply_per_item', 'apply_per_order', 'buy_one_get_another_at_discount', 'apply_free_shipping', 'apply_discount_shipping' |\n| `calculation` | String | Returns the calculation type for this PromotionAction, eg: 'percentage', 'flat_rate' |\n| `discount_percent` | Number | Returns the percentage of discount to apply |\n| `discount_value` | Number | Returns the amount of discount to apply |\n| `discount_value_points` | Number | Returns the amount of discount to apply in points |\n| `id` | String | Returns the unique id for this PromotionAction |\n| `promotion` | [Promotion](promotion-liquid-object-reference) | Returns the Promotion object associated with this PromotionAction |\n| `qualifying_quantity` | Number | Returns the quantity of scoped items needed before the order qualifies for the promotion |\n\n## Available on\n\n- [Promotion - Liquid Object Reference](promotion-liquid-object-reference) — `actions`"}