Here you can find more information about the Product Campaigns organised by TikTok Shop.
TikTok Shop supports two distinct promotion types through Lengow, depending on your promotional goal:
- Fixed-price promotion (FIXED_PRICE): Directly discounts your products by setting a specific, reduced selling price. This setting applies individually at the variant level. Use this option to run direct product price drop campaigns.
- Shipping discount promotion (SHIPPING_DISCOUNT): Reduces or completely waives fulfilment delivery fees without altering the item's retail selling price. This promotion applies at the product level and is therefore identical across all of its variants. Use this option to offer free shipping (FREE_SHIPPING) or capped fee discounts (DISCOUNT_SHIPPING_FEE) across specific delivery methods and geographic zones.
Important
For an EU Global feed (multi-country), Lengow applies updates to each enabled TikTok Shop sales channel. Processing times, regional restrictions, and results may therefore differ between shops.
Create and configure a promotion
Step 1: Select products and configure promotion attributes
Create a rule on the Promotion - Title (promotion.promotion_title) attribute to select the target products. The rule name will serve as your promotion name. Then, fill in the other required attributes for your promotion type (see Step 2).
Promotion consistency rules
Products participating in the same promotion must use exactly the same promotion title. Products sharing a title must also have the same promotion configuration, including the promotion type, duration, dates, and participation limit.
Some values can differ between products, such as the fixed promotional price or quantity limits.
Step 2: Choose your promotion type
Follow the instructions for the promotion type you want to create.
Option 1: Create a fixed-price promotion
Use this option when you want to offer products at specific promotional prices. Select FIXED_PRICE as the promotion type, complete the following attributes:
| Attribute | Description |
|---|---|
| Promotion - Title (promotion.promotion_title) | Enter a name for your promotion. Use exactly the same title for every product participating in the same promotion. The title must be unique across all of your promotions, regardless of the type. Maximum length: 100 characters. |
| Promotion - Type (promotion.promotion_type) | Select FIXED_PRICE. It applies to your selected products to offer them a specific discounted retail price. |
| Promotion - Start time (promotion.promotion_begin_time) | Enter the date and time when the promotion starts (must be in the future). Use an ISO 8601 date/time according to the time zone of your shop (for Central European Time: +01:00 for winter time, +02:00 for summer time): Example: 2026-06-25T01:00:00+02:00 Values without a time zone (+01:00 or +02:00 at the end) are interpreted as UTC. (Unix timestamp format in seconds is also accepted instead of ISO 8601 format) |
| Promotion - End time (promotion.promotion_end_time) | Enter the date and time when the promotion ends. It must be later than the start time. Use the same ISO 8601 format (+01:00 for winter time, +02:00 for summer time) or a Unix timestamp in seconds. The minimum duration for a TikTok promotion is 10 minutes. |
| Promotion - Duration type (promotion.promotion_duration_type) | Select NORMAL for a promotion with a start and end time. This is the default. |
| Promotion - Fixed activity price (promotion.promotion_price) | Enter the exact promotional selling price customers will pay while the campaign is active. Mandatory for FIXED_PRICE promotions. |
| Promotion - Quantity limit (promotion.promotion_quantity_limit) | Define the maximum total number of discounted units available across all buyers combined during this campaign. Enter -1 for unlimited units or an integer between 1 and 99. Default: -1. Note: Once set, this value cannot be decreased. |
| Promotion - Quantity per buyer (promotion.promotion_quantity_per_user) | Define the maximum number of discounted units an individual buyer can purchase. Enter -1 for no restriction or an integer between 1 and 99. Default: -1. Note: Once set, this value cannot be decreased. |
| Promotion - Participation limit (promotion.promotion_participation_limit) | Choose BUYER_NO_LIMIT to allow buyers to place multiple orders at the promotional price, or BUYER_LIMIT_ONLY_ONE to restrict each buyer to a single order. Default: BUYER_NO_LIMIT. |
Option 2: Create a shipping discount
Use this option when you want to offer free shipping or reduce shipping fees for eligible products. Select SHIPPING_DISCOUNT as the promotion type and complete the following attributes.
| Attribute | Description |
|---|---|
| Promotion - Title (promotion.promotion_title) | Enter a name for your promotion. Use exactly the same title for every product participating in the same promotion. The title must be unique across all of your promotions, regardless of the type. Maximum length: 50 characters. |
| Promotion - Type (promotion.promotion_type) | Select SHIPPING_DISCOUNT. |
| Promotion - Start time (promotion.promotion_begin_time) | Enter the date and time when the promotion starts (must be in the future). Use an ISO 8601 date/time: • YYYY-MM-DDTHH:MM:SS+01:00 = Winter time (Central Europe) • YYYY-MM-DDTHH:MM:SS+02:00 = Summer time (Central Europe) Example: 2026-06-25T01:00:00+02:00 Values without a time zone (+01:00 or +02:00 at the end) are interpreted as UTC. (Unix timestamp format in seconds is also accepted instead of ISO 8601 format). Not required if Duration type = INDEFINITE. |
| Promotion - End time (promotion.promotion_end_time) | Enter the date and time when the promotion ends. It must be later than the start time. Use the same ISO 8601 format (+01:00 for winter time, +02:00 for summer time) or a Unix timestamp in seconds. The minimum duration for a TikTok promotion is 10 minutes. Not required if Duration type = INDEFINITE. |
| Promotion - Duration type (promotion.promotion_duration_type) | Select NORMAL for a promotion with a start and end time. This is the default. Select INDEFINITE for shipping discounts without an end time (accepted only for SHIPPING_DISCOUNT). |
| Promotion - Shipping benefit type (promotion.shipping_discount_type) | Select FREE_SHIPPING to fully cover and remove all shipping costs for buyers, or DISCOUNT_SHIPPING_FEE to deduct a fixed monetary amount from the delivery fee. Mandatory for shipping discounts. |
| Promotion - Shipping discount value (promotion.shipping_discount_value) | Enter the exact monetary amount to deduct from the delivery fee in your shop's local currency. Mandatory when DISCOUNT_SHIPPING_FEE is selected. |
| Promotion - Eligible shipping method (promotion.shipping_discount_shipping_method) | Choose STANDARD_SHIPPING, EXPRESS_SHIPPING or ALL_SHIPPING_METHOD to define which delivery options qualify for the discount. Default: STANDARD_SHIPPING. |
| Promotion - Eligible inventory type (promotion.shipping_discount_inventory_type) | Only SELF_FULFILLED is supported. This is the default. |
| Promotion - Shipping area scope (promotion.shipping_discount_area_scope_type) | Select WHOLE to apply the delivery discount across all regions you ship to, or SPECIFIC_AREAS to limit the offer to targeted administrative regions. Mandatory for shipping discounts. |
| Promotion - Specific shipping areas (promotion.shipping_discount_area_scope_specific_areas) | Enter a comma-separated list of exact region names (for example: Ile de France, Bavaria, or Lombardy). Mandatory when SPECIFIC_AREAS is selected. Accepted values come from a fixed list per country: see the list of supported areas by TikTok. Important: In an EU Global feed (multi-country), each country has its own list; a single set of region names cannot be valid across all shops. |
Important
Some attributes are required only when a specific option is selected. For example, Shipping discount value is required for DISCOUNT_SHIPPING_FEE, while Specific shipping areas is required for SPECIFIC_AREAS.
Step 3: Check the promotion in TikTok Shop Seller Center
After processing the feed, open TikTok Shop Seller Center and check that the promotion was created successfully and that the expected products are included. The promotion is visible in TikTok only after TikTok validates and accepts the submitted changes.
Remove products from a promotion
To remove products from an active campaign, update your settings in Lengow. Any changes take effect during the next feed update:
- Remove a specific product: Remove the product(s) from the rule setup under the Promotion - Title attribute.
- Remove all products from a promotion: Disable the rule assigning the promotion title to remove all associated items at once.
Reactivate a deactivated promotion
Republication of a promotion depends on the promotion type:
- FIXED_PRICE promotions: Can be reactivated only if they expired or were deactivated less than 7 days ago.
- SHIPPING_DISCOUNT promotions: Cannot be reactivated or republished. You must create a new promotion with a new title.
To reactivate an eligible FIXED_PRICE promotion for selected products:
- Re-enable the disabled rule in the Promotion - Title attribute to reassign products to the campaign (or create a new rule if needed).
- Check and complete all mandatory promotion attributes required for your campaign type.
- Update start and end dates to valid future times and ensure all configuration settings remain consistent across all participating products.
- Process a feed update to send the changes to TikTok.
- Open TikTok Shop Seller Center to confirm that the promotion has reactivated with the correct products.
Important
TikTok rejects reactivation if the FIXED_PRICE promotion has expired or was deactivated more than 7 days ago, or if it is a SHIPPING_DISCOUNT promotion. In these cases, create a new promotion with a different title.
Troubleshoot promotion errors
TikTok validates each promotion change sent by Lengow. If TikTok rejects an action, Lengow logs the failure in your feed report.
Find and review errors in Lengow
- Open the relevant feed and go to Report → Offers.
- Locate rows with the type Error and select a line to open Issue details.
- Review the Issue code (the failed action) and the Raw message (the detailed TikTok rejection reason and error code).
Understand error levels
- Promotion errors: Relate to the entire campaign (such as creating, republishing or deactivating the promotion). Lengow reports a single error line for the failed promotion action.
- Product errors: Relate to a specific item that could not be added, updated or removed.
- Skipped or deferred errors: Messages starting with "skipped:" or "deferred:" indicate that Lengow withheld the product change because the parent promotion action failed. Resolve the underlying promotion error first, and the product changes will process automatically.
Common TikTok promotion errors
| TikTok error code | Error message | Recommended action |
|---|---|---|
| 17029004 | A promotion name with ... is already in use. | Use a new Promotion - Title. The title must be unique across all of your promotions, regardless of the type. |
| 17029022 | Product already in another active or upcoming promotion. | A product cannot be included in two promotions that are ongoing or upcoming at the same time. Remove the product from the other promotion or wait until it finishes. |
| 17003243 | This activity is not allowed to republish (ActivityExpiredTooLong or TemplateNotSupport). | TikTok does not allow republication if the FIXED_PRICE promotion expired more than 7 days ago, or if it is a SHIPPING_DISCOUNT promotion (which cannot be republished). Create a new promotion with a different title. |
| 17029001 | begin_time must be greater than current time. | Set the promotion start time to a future date and time. |
| 17029011 | Cannot update begin_time for ongoing promotion. | The start date of a promotion that has already started cannot be modified. |
| 17029058 | Quantity limit cannot be decreased. | Once defined, the total quantity limit and the quantity per buyer cannot be decreased. |
| 17029006 / 17029007 | Promotion duration is invalid (too short or too long). | Check the dates: the promotion is either too short (TikTok requires a minimum of 10 minutes) or too long. |
| 17029012 | Cannot edit expired promotions. | The promotion has expired and cannot be modified. Create a new promotion with a different title. |
| 17029010 | The promotion has been deactivated. | Only FIXED_PRICE promotions deactivated for less than 7 days can be reactivated with valid future dates. SHIPPING_DISCOUNT promotions cannot be reactivated. If reactivation is not permitted, create a new promotion with a different title. |
Comments
Please sign in to leave a comment.