docs: docs for next release (#14110)

2025-12-01 20:20:01 +02:00
parent e4513fab88
commit 223ccb4add
24 changed files with 1196 additions and 27 deletions
@@ -95,6 +95,10 @@ If you chose the "Amount off Products" promotion type in the first section, fill
        - Set the Attribute to Product Category.
        - Set the Operator to In.
        - Set the Value to the Shirts product category.
+10. In the Usage Limit field, optionally set the maximum number of times this promotion can be used across all orders.
+    - For example, if you set this field to `10`, the promotion can be used a total of 10 times across all orders. After that, the promotion can't be used anymore.
+    - If left empty, the promotion can be used an unlimited number of times, or until the campaign's usage limit is reached if the promotion is part of a campaign.
+    - You can't update this field after creating the promotion.
 10. Once you're done, click Next and move on to the [next step](#step-3-campaign).

 ![What items will the promotion be applied to section](https://res.cloudinary.com/dza7lstvk/image/upload/v1739898160/User%20Guide/Screenshot_2025-02-18_at_7.02.26_PM_izi1sv.png)
@@ -129,7 +133,11 @@ If you chose the "Amount off Order" promotion type in the first section, fill ou
 ![Who can use this code form](https://res.cloudinary.com/dza7lstvk/image/upload/v1739898239/User%20Guide/Screenshot_2025-02-18_at_7.03.46_PM_iawubi.png)

 6. In the Promotion Value field, set the amount to be discounted from the order when the promotion is applied. The amount is in the currency you chose in the previous section.
-7. Once you're done, click Next and move on to the [next step](#step-3-campaign).
+7. In the Usage Limit field, optionally set the maximum number of times this promotion can be used across all orders.
+    - For example, if you set this field to `10`, the promotion can be used a total of 10 times across all orders. After that, the promotion can't be used anymore.
+    - If left empty, the promotion can be used an unlimited number of times, or until the campaign's usage limit is reached if the promotion is part of a campaign.
+    - You can't update this field after creating the promotion.
+8. Once you're done, click Next and move on to the [next step](#step-3-campaign).

 ### c. Percentage off Product

@@ -185,7 +193,11 @@ If you chose the "Percentage off Product" promotion type in the first section, f
        - Set the Attribute to Product Category.
        - Set the Operator to In.
        - Set the Value to the Shirts product category.
-10. Once you're done, click Next and move on to the [next step](#step-3-campaign).
+10. In the Usage Limit field, optionally set the maximum number of times this promotion can be used across all orders.
+    - For example, if you set this field to `10`, the promotion can be used a total of 10 times across all orders. After that, the promotion can't be used anymore.
+    - If left empty, the promotion can be used an unlimited number of times, or until the campaign's usage limit is reached if the promotion is part of a campaign.
+    - You can't update this field after creating the promotion.
+11. Once you're done, click Next and move on to the [next step](#step-3-campaign).

 ![What items will the promotion be applied to section](https://res.cloudinary.com/dza7lstvk/image/upload/v1739898386/User%20Guide/Screenshot_2025-02-18_at_7.06.14_PM_bdi5jv.png)

@@ -218,7 +230,11 @@ If you chose the "Percentage off Order" promotion type in the first section, fil
 ![Who can use this code section](https://res.cloudinary.com/dza7lstvk/image/upload/v1739898478/User%20Guide/Screenshot_2025-02-18_at_7.07.46_PM_eriyxm.png)

 6. In the Promotion Value field, set the amount to be discounted from applicable products when the promotion is applied. The amount is in the currency you chose in the previous section.
-7. Once you're done, click Next and move on to the [next step](#step-3-campaign).
+7. In the Usage Limit field, optionally set the maximum number of times this promotion can be used across all orders.
+    - For example, if you set this field to `10`, the promotion can be used a total of 10 times across all orders. After that, the promotion can't be used anymore.
+    - If left empty, the promotion can be used an unlimited number of times, or until the campaign's usage limit is reached if the promotion is part of a campaign.
+    - You can't update this field after creating the promotion.
+8. Once you're done, click Next and move on to the [next step](#step-3-campaign).

 ### e. Buy X Get Y

@@ -281,7 +297,11 @@ If you chose the "Buy X Get Y" promotion type in the first section, fill out the
            - Set the Attribute to Product Category.
            - Set the Operator to "Not In".
            - Set the Value to the "Shirt" category.
-7. Once you're done, click Next and move on to the [next step](#step-3-campaign).
+7. In the Usage Limit field, optionally set the maximum number of times this promotion can be used across all orders.
+    - For example, if you set this field to `10`, the promotion can be used a total of 10 times across all orders. After that, the promotion can't be used anymore.
+    - If left empty, the promotion can be used an unlimited number of times, or until the campaign's usage limit is reached if the promotion is part of a campaign.
+    - You can't update this field after creating the promotion.
+8. Once you're done, click Next and move on to the [next step](#step-3-campaign).

 ### f. Free Shipping

@@ -324,7 +344,11 @@ If you chose the "Free Shipping" promotion type in the first section, fill out t
        - Set the Attribute to Shipping Option Type.
        - Set the Operator to In.
        - Set the Value to the "Express" shipping option type.
-6. Once you're done, click Next and move on to the [next step](#step-3-campaign).
+6. In the Usage Limit field, optionally set the maximum number of times this promotion can be used across all orders.
+    - For example, if you set this field to `10`, the promotion can be used a total of 10 times across all orders. After that, the promotion can't be used anymore.
+    - If left empty, the promotion can be used an unlimited number of times, or until the campaign's usage limit is reached if the promotion is part of a campaign.
+    - You can't update this field after creating the promotion.
+7. Once you're done, click Next and move on to the [next step](#step-3-campaign).

 ![What shipping methods will the promotion be applied to section](https://res.cloudinary.com/dza7lstvk/image/upload/v1756368838/User%20Guide/CleanShot_2025-08-28_at_11.13.29_2x_rdcivr.png)