Menu
Feedback
Start here
Tutorials


Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
Promotions & taxes
Promotions
How the progressive discount promotion works
7 min read

Progressive Discount is a feature that allows you to create promotions with increasing discount percentages as the customer adds more products to the cart. This strategy is perfect for boosting larger purchases and rewarding the customer with benefits based on the number of items purchased.

{"base64":"  ","img":{"width":1677,"height":941,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":780897,"url":"https://images.ctfassets.net/alneenqid6w5/5bWDJyWkKBJaoER9XPBkEq/7e19eeb9823179a8930cc20e3d0a62e4/Desconto_Progressivo-EN.gif"}}

To configure the Progressive Discount promotion, you need to complete the following steps:

Creating a Progressive Discount promotion

  1. In the VTEX Admin, go to Promotions > Promotions, or type Promotions in the search bar at the top of the page.
  2. Click Create Promotion.
  3. Select the Progressive Discount option.
  4. Complete the fields. You can find details of how to complete them in the table below.
  5. Click Save.

Segue a tabela convertida para o formato Markdown, substituindo as células vazias por "IMAGEMAQUI":

FieldDescriptionExample
NameEnter a clear and objective name that reflects the purpose of the promotion, making it easy for customers to identify it (up to 150 characters).Summer Clearance.
StatusDefine whether the promotion will be Active or Inactive. Configure as <i class="fas fa-toggle-on" aria-hidden="true"></i> to apply the promotion based on the configured dates and times. Set as <i class="fas fa-toggle-off" aria-hidden="true"></i> to pause it, even if it is within the defined period.
{"base64":"  ","img":{"width":111,"height":56,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":1221,"url":"https://images.ctfassets.net/alneenqid6w5/53JRRDwnwqYZHkAvXDHZ4q/3f76ac889196c32d02639e71bc3937d3/Habilitar_Promotions-_EN.png"}}
{"base64":"  ","img":{"width":121,"height":54,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":1251,"url":"https://images.ctfassets.net/alneenqid6w5/3kMog54wFdkBKNgBOped6G/39d4b4b39ea2f4262325476d53a0fd81/Desabilitar_Promotions-EN.png"}}
DescriptionThe internal promotion description should be used to record information for internal communication (up to 10,000 characters). This field is used to specify the purpose of the promotion, such as a specific campaign or clearance.Promotion for clearing summer collection items.
Start date and timeSelect the date and time the promotion will start, ensuring that it is activated when you want it to. Make sure date and time align with campaign planning to maximize effectiveness.
{"base64":"  ","img":{"width":679,"height":88,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":4848,"url":"https://images.ctfassets.net/alneenqid6w5/5gTtMgL4HlIDqOLXr0GlkR/5f616c9cd72f92aca617da1d3a52eceb/Data_e_horario_de_inicio_da_Promotions-EN.png"}}
End date and timeDefine the expiration date of the promotion by setting the date and time it will be automatically deactivated.
{"base64":"  ","img":{"width":677,"height":87,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":4609,"url":"https://images.ctfassets.net/alneenqid6w5/47LXgLL2EnmPdeB7HBDAlc/f3572e0e51e30efa09e3c139b544c317/Data_de_termino_e_horario_da_Promotions-EN.png"}}
Use recurrence settingsSelect this option to schedule the promotion to repeat automatically on specific days and times. Set the desired ranges to ensure recurrence as scheduled.
{"base64":"  ","img":{"width":553,"height":647,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":23712,"url":"https://images.ctfassets.net/alneenqid6w5/45x0h14pQOrpBu6RacEheI/72ba9f5a8f2ec41b30ccee985d50dc7f/Usar_recorrencia_Promotions-EN.png"}}

Sellers

In the right-hand corner of the page, in the Sellers, section, define the sellers that the promotion should apply to.

{"base64":"  ","img":{"width":436,"height":176,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":5045,"url":"https://images.ctfassets.net/alneenqid6w5/cOayrbcrmuwe2BfyUMOGS/4434bdf930beb8b41c10121b949fd634/Seller-EN.png"}}

Select one of the following options for applying the promotion:

  • All: The promotion will be applied to all sellers. Use this option if you want all products from all sellers to be part of the campaign.
  • Same as: The promotion will only be applied to specific sellers. After selecting this option, complete the field that will display the names of the desired sellers.
  • Different from: Define the sellers that will not be affected by this promotion. After selecting "Different from", you can choose the sellers you don't want to include in the campaign. All other sellers will be included.

Trade policies

In the right-hand corner of the page, in the section Trade policies, select the trade policies valid for the discount. You can give discounts for trade policies when your store acts as a marketplace (My store) or as a seller (Third-party stores - Fulfillment).

You can choose from the following options:

  • All: Select this option to apply the promotion to all trade policies without any restrictions. All products, regardless of the associated trade policy, will be included in the promotion.
  • Equal to: This option allows you to determine the policies that will apply to the products eligible for the discount.
  • Different from: This option removes specific policies, ensuring the discount is not applied to products that use those business rules.

{"base64":"  ","img":{"width":438,"height":178,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":8784,"url":"https://images.ctfassets.net/alneenqid6w5/2pa7FR8lrDdSJt7cdZl48b/ca16106afc16cd7a6d09bad8e19da028/Politica_comercial-EN.png"}}

Set the conditions for the Progressive Discount promotion

Determine the conditions and discount percentages to be applied. See the available conditions below:

  • SKUs: Select the SKUs that the progressive discount will apply to. This option restricts the promotion to products associated with the selected SKUs.
  • Collections: Select the product collections that the progressive discount will apply to. This option allows you to apply the promotion to a group of predefined products.
  • Must be the same item: This option restricts the discount to products that are the same. For example, if you add different SKUs from the same collection, the promotion won't be applied. The rule only checks the quantity of the single SKU in the cart.
  • Discount: Set the discount percentage applied when the minimum quantity of items defined is reached. You can create up to 10 progressive discount ranges.
  • Add range: Configure additional progressive discount levels. For example, you can define a 5% discount with a quantity of 10, and an increase to 10% when the quantity reaches 20. The maximum number of configurable ranges is 10.

{"base64":"  ","img":{"width":554,"height":804,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":47468,"url":"https://images.ctfassets.net/alneenqid6w5/3SznyBALv0e59SC2J2XMvH/9113b3422de0b767abb41a0c8121e91e/Desconto_Promotions-EN.png"}}

Setting conditions for applying the promotion

Conditions allow the promotion to activate under specific circumstances based on the selected criteria. To add a condition, follow the instructions below:

  • Card BIN: Apply this promotion when using cards from specific networks, banks, or categories identified by their BIN codes. Import a list of BINs saved in a TXT or CSV file, with each BIN on a separate row.
  • Customer cluster: select an already created customer cluster in Master Data, following the field=value or field contains value format. Select one of the following options:
    • All of the following: Apply the promotion only if all cluster criteria are met.
    • At least one of the following: Apply the promotion if at least one of the cluster criteria is met.
  • Shipping location: Apply the promotion based on the shipping address associated with the order. Conditions can be configured using the following criteria:
    • Countries: Specify the countries in which the promotion will be valid. You can select up to 50 countries from the list. The promotion will only apply to orders with shipping linked to the configured countries.
    • Shipping postal code: Configure postal code ranges to limit the application of the promotion to specific regions.
      • Choose Include or Exclude: Define whether the promotion will apply to the configured ranges (Include) or to the excluded values (Exclude).
      • Configure the postal code ranges: Complete the "From" and "To" fields with the desired postal codes.
      • Add multiple ranges: Use the + Add range option to include add ranges as necessary.

{"base64":"  ","img":{"width":541,"height":486,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":28779,"url":"https://images.ctfassets.net/alneenqid6w5/2Hv9G5dZovZhdCoqFF75oy/26951daaa32e130f4ca5dda78fd630af/CEP_Promotions-EN.png"}}

  • UTM: Configure the promotion to apply when the site is accessed via a URL with UTM parameters or when a coupon linked to these parameters is used. Set the UTM parameters according to the formatting rules, using only letters, numbers, hyphens, and underscores.

Using these parameters is optional and allows you to apply discounts to specific campaigns.

Set the following parameters if necessary:

  • utm_source: Apply the discount when browsing occurs through the configured utm_source parameter.
  • utm_campaign: Apply the discount when browsing occurs through the configured utm_campaign parameter.
  • Create coupon from the UTM parameters above: Generate a coupon based on the UTM parameters entered in the UTM_source and UTM_campaign fields.
  • View linked coupons: View the coupons that have already been associated with the defined UTM parameters.
  • Payment method: The promotion is only applied when the customer uses one of the previously configured payment methods. The options include:
    • Boleto Bancário (Brazil).
    • Credit cards, such as Visa or Mastercard.
    • Other methods, such as Diners or Hipercard.

Setting usage restrictions

In this section, determine whether the promotion can be combined with other promotions. The available options are:

  • Limit the use of the promotion in the store: Restrict the number of times the promotion can be used in the store.
  • Limit the use of the promotion per customer: Restrict the number of times each customer can use the promotion.
  • Limit the number of eligible items per cart: Define the maximum number of items per order that will get the discount.

Configure combination and competition

Define how the promotion will be combined with other business conditions applied in the store.

  • Allow combining with manual prices: Select this setting so that the promotion is applied to products whose price has been adjusted.

Displaying the promotion on the product page

In this section, you can highlight the promotion on the product listing page and add custom data for in-store customizations.

  • Highlight promotion on products: Check this option to display the promotion directly on the product listing pages.
  • Additional information: Click Create to add custom fields with name and value, which can be used for store customizations.
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
How is shipping cost calculated when there's an item with shipping benefit on the cart?
« Previous
How promotion competition works
Next »
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback