Menu
Feedback
Start here
Tutorials


Promotion List

The VTEX platform allows you to optimally and practically add different promotion types suited for different scenarios. Through a centralized interface for managing promotions, your store can offer more benefits focused on customer attraction and retention.

The Promotions module is flexible when it comes to creating promotion scenarios with specific conditions for different contexts. Besides filtering and exporting promotions, you can view the active ones and archive them.

Access the page in the VTEX Admin through the Promotions > Promotions.

The page displays the list of your store's promotions and their basic information:

Field nameDescription
NamePromotion name.
FromPromotion start date.
ToPromotion end date.
StatusPromotion status, which can be: Active: when a promotion is active.

Scheduled: when the promotion was scheduled.

Paused: when the promotion is paused. Completed: when the promotion ended.

|

{"base64":"  ","img":{"width":1621,"height":878,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":1660853,"url":"//images.ctfassets.net/alneenqid6w5/3QkCDSGnYVvzz6ygn3ZUm8/c790e13db5f9ce7b8e9fa276478813d1/listadepromocoes_en.gif"}}

You can sort the promotions by name, date, or status. To do this, click on the title of the column with the information you want to use as sorting criteria.

All the features available on the page will be described in the following sections:

Creating promotions

To add a new promotion, click the Create Promotion button. Then, you can select the following types of promotions:

Archived promotions

To access the Archived Promotions page, click the icon and then .

You can unarchive or duplicate archived promotions by clicking the icon. When you unarchive a promotion, its status will change to Paused.

Search promotions

You can use the search bar to search for a specific promotion by name, description, or UTM.

Export promotions

You can download a CSV file with the promotions available in your store and their respective information. To do this, click the Export button next to the search bar. The exported file considers the filters applied to the list and does not include archived promotions.

The file contains the following information about each promotion:

ColumnDescription
IDThe promotion ID.
NameThe promotion name.
Discount TypeType of discount applied in the promotion.
FromThe promotion start date.
ToThe promotion end date.
StatusThe current promotion status. Possible options are Active, Scheduled, Paused, or Completed.

Promotion usage

{"base64":"","img":{"width":470,"height":161,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":14663,"url":"//images.ctfassets.net/alneenqid6w5/5cvRZbj2TqwHuQcx6jjqm4/d94a8916fcd88257d83f8c8edd0a0dbf/usodaspromo____es_en.JPG"}}

To view the total of your active promotions and the remaining quota for new promotions, click Promotion usage.

By default, the maximum number of active promotions is 100. If you need to increase this limit, please contact our Support.

Filter promotions

{"base64":"","img":{"width":838,"height":641,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":152837,"url":"//images.ctfassets.net/alneenqid6w5/5ejpdUDVPbixeLp6nmDB1q/d637dba80b4cbda6194cae7cbf630785/filtrodepromocoes_en.gif"}}

The promotion list can be filtered according to your needs by using the following filters:

  • Discount type: The type of discount that will be applied to the promotion. The options are: Regular, Buy Together - Bundle, More for Less, Progressive Discount, Buy One Get One, and Campaign Promotion.
  • Status: The status of the promotion. The options are: Active, Scheduled, Paused, and Completed.
  • Last modified: Last update history for the last 12 months, 3 months, 30 days, 7 days, or the day before the query.
  • Trade policy: Trade policy under which the promotion will be applied.
  • UTM: URL parameters used to track traffic. The options are With UTM and Without UTM.

Select the desired filters and click on Apply to filter the promotions. To cancel the selection, click on Clear on the desired filters.

Actions menu in the promotion list

By clicking on the icon in a promotion, you can perform the following actions:

  • Edit: edit the promotion
  • Deactivate: pause the promotion.
  • Duplicate: create a copy of the promotion.
  • Archive: archive the promotion. The promotion will automatically be moved to the Archived Promotions page.

Learn more

Contributors
3
Photo of the contributor
Photo of the contributor
Photo of the contributor
+ 3 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Regular promotion with nominal discount based on formula
« Previous
Configuring promotions for marketplaces
Next »
Contributors
3
Photo of the contributor
Photo of the contributor
Photo of the contributor
+ 3 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