{"sections":[{"id":"discount-methods","title":"Discount Methods","level":"H2"},{"id":"discount-types","title":"Discount Types","level":"H2"},{"id":"discount-syntax","title":"Discount Syntax","level":"H2"}],"html":"

Discount Methods

"},{"_uid":"569eb604-6b47-41a2-8982-b09294d0c9dc","name":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"discount_quantity_percentage","type":"text","marks":[{"type":"code"}]}]}]},"component":"parameter___item","description":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Accepts:","type":"text","marks":[{"type":"bold"}]},{"text":" A valid ","type":"text"},{"text":"discount","type":"text","marks":[{"type":"link","attrs":{"href":"https://wiki.foxycart.com/v/2.0/coupons_and_discounts#syntax","uuid":null,"anchor":null,"target":null,"linktype":"url"}}]},{"text":" string.","type":"text"},{"type":"hard_break"},{"text":"Notes:","type":"text","marks":[{"type":"bold"}]},{"text":" Discounts by a percentage, based on the quantity of to-be-discounted products. Abbreviated ","type":"text"},{"text":"%/qty","type":"text","marks":[{"type":"code"}]},{"text":". Note that the value is based on the ","type":"text"},{"text":"average","type":"text","marks":[{"type":"italic"}]},{"text":" of all applicable products, so applying this discount to differently priced items will result in an averaged discount.","type":"text"}]}]},"_editable":""},{"_uid":"56228ff6-90f0-49fe-a979-b2aaf4dfd332","name":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"discount_price_amount","type":"text","marks":[{"type":"code"}]}]}]},"component":"parameter___item","description":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Accepts:","type":"text","marks":[{"type":"bold"}]},{"text":" A valid ","type":"text"},{"text":"discount","type":"text","marks":[{"type":"link","attrs":{"href":"https://wiki.foxycart.com/v/2.0/coupons_and_discounts#syntax","uuid":null,"anchor":null,"target":null,"linktype":"url"}}]},{"text":" string.","type":"text"},{"type":"hard_break"},{"text":"Notes:","type":"text","marks":[{"type":"bold"}]},{"text":" Discounts by an amount, based on the price of to-be-discounted products. Abbreviated ","type":"text"},{"text":"$/$","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},"_editable":""},{"_uid":"33391d04-1ae6-44b2-bca6-e23251e68102","name":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"discount_price_percentage","type":"text","marks":[{"type":"code"}]}]}]},"component":"parameter___item","description":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Accepts:","type":"text","marks":[{"type":"bold"}]},{"text":" A valid ","type":"text"},{"text":"discount","type":"text","marks":[{"type":"link","attrs":{"href":"https://wiki.foxycart.com/v/2.0/coupons_and_discounts#syntax","uuid":null,"anchor":null,"target":null,"linktype":"url"}}]},{"text":" string.","type":"text"},{"type":"hard_break"},{"text":"Notes:","type":"text","marks":[{"type":"bold"}]},{"text":" Discounts by a percentage, based on the price of to-be-discounted products. Abbreviated ","type":"text"},{"text":"%/$","type":"text","marks":[{"type":"code"}]},{"text":". Note that the value is based on the ","type":"text"},{"text":"average","type":"text","marks":[{"type":"italic"}]},{"text":" of all applicable products, so applying this discount to differently priced items will result in an averaged discount.","type":"text"}]}]},"_editable":""}],"component":"help_center_parameter","_editable":""},"slug":"product-discount-methods","full_slug":"help/parameters/product-discount-methods","sort_by_date":null,"position":-20,"tag_list":[],"is_startpage":false,"parent_id":5328381,"meta_data":null,"group_id":"8f5dca9c-6b19-4b8e-9a45-c47df2d41d17","first_published_at":"2024-04-06T22:55:30.496Z","release_id":null,"lang":"default","path":null,"alternates":[],"default_full_slug":null,"translated_slugs":null,"_stopResolving":true},"items":[],"component":"help___parameters","_editable":""}\" data-blok-id=\"63f30f8a-edfc-4a60-bef1-ee221f607bbd\" style=\"display: none\">

Discount Types

"},{"_uid":"618150cb-149f-46dd-a2bb-a1f5f66c6242","name":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"incremental","type":"text","marks":[{"type":"code"}]}]}]},"component":"parameter___item","description":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Also Called:","type":"text","marks":[{"type":"bold"}]},{"text":" Incremental Quantity Discounts","type":"text"}]},{"type":"paragraph","content":[{"text":"Description:","type":"text","marks":[{"type":"bold"}]},{"text":" Discounts only the units ","type":"text"},{"text":"above","type":"text","marks":[{"type":"italic"}]},{"text":" the tiers you set.","type":"text"},{"type":"hard_break"},{"text":"Notes:","type":"text","marks":[{"type":"bold"}]},{"text":" Most useful for individual products or many products with the same price. Not useful for ","type":"text"},{"text":"$/$","type":"text","marks":[{"type":"code"}]},{"text":" discount methods.","type":"text"},{"type":"hard_break"},{"text":"Examples:","type":"text","marks":[{"type":"bold"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Scenario:","type":"text","marks":[{"type":"bold"}]},{"text":" Buy two products, get additional products at $5 off. (The first two are not discounted.)","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Method:","type":"text","marks":[{"type":"bold"}]},{"text":" ","type":"text"},{"text":"discount_quantity_amount","type":"text","marks":[{"type":"code"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Logic:","type":"text","marks":[{"type":"bold"}]},{"text":" ","type":"text"},{"text":"incremental|3-5","type":"text","marks":[{"type":"code"}]},{"type":"hard_break"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Scenario:","type":"text","marks":[{"type":"bold"}]},{"text":" With a quantity of 1-10, all products are at 100% (no discount). With a quantity of 150, 10 products would be at 100%, 40 would be at 90%, 50 would be at 85%, and 50 would be at 80%.","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Method:","type":"text","marks":[{"type":"bold"}]},{"text":" ","type":"text"},{"text":"discount_quantity_percentage","type":"text","marks":[{"type":"code"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Logic:","type":"text","marks":[{"type":"bold"}]},{"text":" ","type":"text"},{"text":"incremental|11-10|51-15|101-20","type":"text","marks":[{"type":"code"}]}]}]}]}]}]}]},"_editable":""},{"_uid":"be77f04d-61eb-4d78-8547-affc8c3a1002","name":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"repeat","type":"text","marks":[{"type":"code"}]}]}]},"component":"parameter___item","description":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Also Called:","type":"text","marks":[{"type":"bold"}]},{"text":" Buy One, Get One (BOGO), or “Repeatable Incremental Quantity Discounts”","type":"text"},{"type":"hard_break"},{"text":"Description:","type":"text","marks":[{"type":"bold"}]},{"text":" Repeatable discounts are somewhat similar to ","type":"text"},{"text":"incremental","type":"text","marks":[{"type":"code"}]},{"text":" discounts, but only have a single tier that repeats. Using this method you can achieve “buy one get one free” types of discounts that repeat (buy 1 get 1, or buy 3 get 3). You can also do something like “buy 3 get the 4th at $5 off”, so buying 5 or 6 would only get a single $5 discount, but buying 8 would get a $10 discount.","type":"text"},{"type":"hard_break"},{"text":"Notes:","type":"text","marks":[{"type":"bold"}]},{"text":" Not useful for ","type":"text"},{"text":"$/$","type":"text","marks":[{"type":"code"}]},{"text":" discount methods. Only accepts one tier.","type":"text"},{"type":"hard_break"},{"text":"Examples:","type":"text","marks":[{"type":"bold"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Scenario:","type":"text","marks":[{"type":"bold"}]},{"text":" Buy one, get one free (100% off).","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Method:","type":"text","marks":[{"type":"bold"}]},{"text":" ","type":"text"},{"text":"discount_quantity_percentage","type":"text","marks":[{"type":"code"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Logic:","type":"text","marks":[{"type":"bold"}]},{"text":" ","type":"text"},{"text":"repeat|2-100","type":"text","marks":[{"type":"code"}]},{"type":"hard_break"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Scenario:","type":"text","marks":[{"type":"bold"}]},{"text":" Buy 3, get the 4th at 50% off.","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Method:","type":"text","marks":[{"type":"bold"}]},{"text":" ","type":"text"},{"text":"discount_quantity_percentage","type":"text","marks":[{"type":"code"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Logic:","type":"text","marks":[{"type":"bold"}]},{"text":" ","type":"text"},{"text":"repeat|4-50","type":"text","marks":[{"type":"code"}]}]}]}]}]}]}]},"_editable":""},{"_uid":"cfbc0394-8a11-40d7-9835-6693802fbb58","name":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"single","type":"text","marks":[{"type":"code"}]}]}]},"component":"parameter___item","description":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Also Called:","type":"text","marks":[{"type":"bold"}]},{"text":" Single Discount, One-Off Discount; or Coupon mode","type":"text"},{"type":"hard_break"},{"text":"Description:","type":"text","marks":[{"type":"bold"}]},{"text":" Unlike the other discount types, the ","type":"text"},{"text":"single","type":"text","marks":[{"type":"code"}]},{"text":" discount type applies one single discount and not a quantity discount across all products.","type":"text"},{"type":"hard_break"},{"text":"Notes:","type":"text","marks":[{"type":"bold"}]},{"text":" ","type":"text"},{"text":"single","type":"text","marks":[{"type":"code"}]},{"text":" is the default discount type for ","type":"text"},{"text":"coupons","type":"text","marks":[{"type":"link","attrs":{"href":"https://wiki.foxycart.com/v/2.0/coupons_and_discounts","uuid":null,"anchor":null,"target":null,"linktype":"url"}}]},{"text":", as it makes the most sense in that context. For ","type":"text"},{"text":"%/qty","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"%/$","type":"text","marks":[{"type":"code"}]},{"text":" a ","type":"text"},{"text":"single","type":"text","marks":[{"type":"code"}]},{"text":" discount type will yield the same discount as ","type":"text"},{"text":"allunits","type":"text","marks":[{"type":"code"}]},{"text":". Note that “allunits” is the default discount type for product and category discounts.","type":"text"},{"type":"hard_break"},{"text":"Examples:","type":"text","marks":[{"type":"bold"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Scenario:","type":"text","marks":[{"type":"bold"}]},{"text":" Buy any 5 products, get $10 off your order.","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Method:","type":"text","marks":[{"type":"bold"}]},{"text":" ","type":"text"},{"text":"discount_quantity_amount","type":"text","marks":[{"type":"code"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Logic:","type":"text","marks":[{"type":"bold"}]},{"text":" ","type":"text"},{"text":"single|5-10","type":"text","marks":[{"type":"code"}]}]}]}]}]}]}]},"_editable":""}],"component":"help_center_parameter","_editable":""},"slug":"product-discount-types","full_slug":"help/parameters/product-discount-types","sort_by_date":null,"position":-30,"tag_list":[],"is_startpage":false,"parent_id":5328381,"meta_data":null,"group_id":"4afc8f56-e925-49fd-9e6c-3b406b16c271","first_published_at":"2024-04-06T23:22:46.432Z","release_id":null,"lang":"default","path":null,"alternates":[],"default_full_slug":null,"translated_slugs":null,"_stopResolving":true},"items":[],"component":"help___parameters","_editable":""}\" data-blok-id=\"63f30f8a-edfc-4a60-bef1-ee221f607bbd\" style=\"display: none\">

Discount Syntax

"}],"component":"help_center_parameter","_editable":""},"slug":"product-discount-syntax","full_slug":"help/parameters/product-discount-syntax","sort_by_date":null,"position":-50,"tag_list":[],"is_startpage":false,"parent_id":5328381,"meta_data":null,"group_id":"85d99a2b-856d-4c65-9475-1b55534462d6","first_published_at":"2024-04-06T23:35:18.407Z","release_id":null,"lang":"default","path":null,"alternates":[],"default_full_slug":null,"translated_slugs":null,"_stopResolving":true},"items":[],"component":"help___parameters","_editable":""}\" data-blok-id=\"63f30f8a-edfc-4a60-bef1-ee221f607bbd\" style=\"display: none\">

In This Article

Need Help?

Discount Parameters

Discount Methods

Discount Types

Discount Syntax

Need Help?