Add missing files

changelog/2024/2024-10-30-changelog.md

@@ -0,0 +1,9 @@
+---
+title: 'Added skuless product selection in Promotions Builder'
+date: '2024-10-30'
+tags: ['Commerce Manager', 'Promotions Builder']
+hide_blog_post_date: false
+---
+
+**MINOR** We have introduced the ability to select SKU-less product bundles in the promotion builder's product selector. For more information, see [Creating a Cart Items Condition in Commerce Manager](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-cart-items-condition).
+

changelog/2024/2024-10-31-changelog.md

@@ -0,0 +1,14 @@
+---
+title: '"Deep linking" in Commerce Manager'
+date: '2024-10-31'
+tags: ['Commerce Manager', 'Core']
+hide_blog_post_date: false
+---
+
+**MAJOR** We have introduced the ability to "deep link" in Commerce Manager
+
+We have improved the way we handle organization and store switching. We now have the organization and/or store id stored the url, so you can easily share the url with others and they will be taken to the same organization and store you were in when you copied the url.
+
+You can now have multiple tabs/windows open in your browser and switch between organizations and stores without having to worry about losing your state.
+
+This does mean any bookmarks you have for say https://euwest.cm.elasticpath.com/products will no longer work as expected because it doesn't have the store/organization id in the url. You should instead be redirected to the store selection page and once you select the store you will be taken to the correct page.

changelog/2024/2024-11-05-changelog.md

@@ -0,0 +1,13 @@
+---
+title: 'Added Flows support for Promotions Builder'
+date: '2024-11-05'
+tags: ['Commerce Manager', 'Promotions Builder']
+hide_blog_post_date: false
+---
+
+**MINOR** We have introduced Flows support for Promotions Builder that allows users to create custom fields for promotions. For example, you can create cusom fields to [display custom promotion terms and conditions](guides/How-To/promotions-builder/use-flows-with-promo-builder.mdx) messaging in the storefront.
+
+For API, see [The Promotions Builder Custom Fields API](/docs/promotions-builder/promotions-builder-api/promotions-builder-api-overview#the-promotions-builder-custom-fields).
+
+For Commerce Manager, see [Editing custom fields in a promotion builder](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#editing-custom-fields-in-a-promotion)
+

guides/How-To/promotions-builder/_category_.json

@@ -0,0 +1,4 @@
+{
+    "position": 85,
+    "label": "Promotions Builder"
+}

guides/How-To/promotions-builder/buy-x-get-y-promotion.mdx

@@ -0,0 +1,14 @@
+---
+title: Creating a Buy X Get Y (BXGY) Promotion
+nav_label: Buy X, Get Y Promotion
+sidebar_position: 20
+---
+
+Let's consider a scenario where you want to offer a discount on silver jewelery for shoppers who buy gift cards for the holidays.
+
+To set this up in the Promotions Builder:
+
+1. Configure a [Cart Items condition](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-cart-items-condition), and select **Product** option and add the eligible gift card items.
+2. Create a [BXGY](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-bxgy-promotion) promotion in the **Actions** section. Configure an item discount for 70% off on all products with the *jewellery-metal-type* template, which contains *metal-type* with values as *silver*.
+
+![Creating a Buy X Get Y (BXGY) Promotion](/assets/promotion-example-scenario-2.png)

guides/How-To/promotions-builder/excluding-items-from-both-eligibility-and-discount.mdx

@@ -0,0 +1,19 @@
+---
+title: Creating a Promotion to Exclude Products from Both Eligibility and Discount
+nav_label: Excluding Items from Promotion Eligibility
+sidebar_position: 80
+---
+
+Let's say you want to create a promotion where specific products are excluded from both making the cart eligible for a discount 
+and from receiving the discount themselves.
+
+In this scenario, if shoppers buy any product from the *Fashion Rings* category, they can receive a 20% discount on other 
+products from the *Fashion Rings Jewellery* category. However, products with the attribute *Platinum Metal Type* are excluded. 
+This means these products will not make the cart eligible for the discount, nor will they receive the discount if they are included in the cart.
+
+To set this up in the Promotions Builder:
+
+1. **Add a condition and exclusions**: Select the eligible category for the promotion condition, such as the *Fashion Rings* category, to define which products can qualify for the discount, and specify any products or attributes to be excluded from the promotion. For example, exclude products with the *Platinum Metal Type* attribute to ensure they do not make the cart eligible for a discount.
+1. **Configure the action and exclusions**: Configure a BXGY promotion in the **Actions** section to offer 20% off products in the *Fashion Rings Jewellery* category. After configuring the action, add exclusions to ensure that products with the *Platinum Metal Type* attribute are also excluded from receiving the discount. See [Creating a BXGY Promotion](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-bxgy-promotion).
+
+![Creating a Promotion to Exclude Products from Both Eligibility and Discount](/assets/promotion-example-scenario-7-2.png)

guides/How-To/promotions-builder/excluding-items-from-discount-eligibility.mdx

@@ -0,0 +1,17 @@
+---
+title: Creating a Promotion to Exclude Items from Promotion Eligibility
+nav_label: Excluding Items from Promotion Eligibility
+sidebar_position: 70
+---
+
+**Use Case:** You want to create a promotion where certain products are excluded from making the cart eligible for a discount.
+
+In this scenario, you can set a condition to exclude specific products, categories, or products with certain attributes from making the promotion eligible for a discount. For example, if shoppers buy any product in the *Fashion Rings Jewellery* category, they will receive 20% off one of the cheapest items. However, if the excluded item, such as the *Platinum Flower ring*, is the only item in the cart, the discount will not be triggered.
+
+To set this up in the Promotions Builder:
+
+1. **Add a condition**: Select the eligible category for the promotion condition, such as the *Fashion Rings Jewellery* category, to determine which products should be considered for the discount.
+1. **Add exclusion**: Specify the specific products, categories, or attributes that should be excluded from making the cart eligible for a discount. For example, exclude the *Platinum Flower ring*.
+1. **Set up the promotion**: Specify the discount details, such as the percentage off and applicable products or categories in the **Actions** section. See [Creating Actions](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-actions).
+
+![Creating a Promotion to Exclude Items from Promotion Eligibility](/assets/promotion-example-scenario-7-1.png)

guides/How-To/promotions-builder/first-time-shopper-promotion.mdx

@@ -0,0 +1,17 @@
+---
+title: Creating First-Time Shopper Promotion
+nav_label: First-Time Shopper Promotion
+sidebar_position: 90
+---
+
+**Use Case:** You want to offer a First-Time Shopper Promotion to attract new shoppers to your store. 
+This promotion can be customized with various discount types and rules, but a common approach is to offer a 10% discount on their first order.
+
+This promotion requires the creation of a public coupon code. You can configure the code so that it is only applicable to shoppers who do not have any prior paid order history in their account. See [Create a Single Code](/docs/commerce-manager/promotions-builder/creating-promotion-codes#creating-a-single-code).
+
+**Key Conditions**:
+
+- The shopper must have an account with no previous paid orders.
+- The promotion is valid only for their first completed order.
+
+![Creating First-Time Shopper Promotion](/assets/first-time-shopper.png)

guides/How-To/promotions-builder/fixed-price-discount.mdx

@@ -0,0 +1,18 @@
+---
+title: Creating a Fixed Price Discount Promotion
+nav_label: Fixed Price Discount
+sidebar_position: 60
+hide_title: true
+---
+
+**Use Case:** You want to offer a discounted price for a particular product using the promotion code, rather than discounting the price for all shoppers in Price Books.
+
+To set this up in the Promotions Builder:
+
+1. Specify the cart item to target the specific product. To do this, see [Cart Item condition](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-cart-items-condition).
+2. Create an [Item Discount](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-an-item-discount-promotion) in the **Actions** section and choose **a fixed price**.
+3. Specify the quantity required to avail the discounted price for the item.
+
+By implementing this, shoppers can use a promotion code to purchase the product at a reduced price, offering targeted discounts without affecting all shoppers in Price Books.
+
+![Creating a Fixed Price Discount Promotion](/assets/promotion-example-scenario-6.png)

guides/How-To/promotions-builder/index.mdx

@@ -0,0 +1,18 @@
+---
+title: Creating Promotions using Promotions Builder
+nav_label: Creating Promotions using Promotions Builder
+sidebar_position: 0.5
+---
+
+The Promotions Builder enables you to offer a wide range of targeted discounts to shoppers, from straightforward percentage discounts to complex, multi-tiered promotions. Each guide in this section provides step-by-step instructions for setting up specific types of promotions to help you meet your business objectives.
+
+These guides will show you how to:
+
+- Set up discounts based on product attributes and shopper profiles
+- Create "Buy X, Get Y" offers and multiple discount actions
+- Build tiered promotions for varying cart totals
+- Limit discounts based on quantity or excluding specific products
+and more!
+
+Explore each guide to master Promotions Builder and customize your store’s promotional offerings.
+

guides/How-To/promotions-builder/promotion-with-custom-attributes.mdx

@@ -0,0 +1,18 @@
+---
+title: Creating a Promotion with Custom Attributes
+nav_label: Promotion with Custom Attributes
+sidebar_position: 10
+---
+
+**USe Case:** You want to offer registered shoppers a 20% discount when they purchase products made of platinum metal.
+
+The system checks if the shopper is registered and if the product they added is made of platinum.
+
+To set this up in the Promotions Builder:
+1. Create a [Cart Custom attribute](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#adding-cart-custom-attributes) that determines if your shoppers are registered when shopping. Set this value as **true** for anyone who has signed up for an account.
+2. Configure a [Cart Items condition](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-cart-items-condition) to check for the product attribute as metal type, and specify that the discount applies to product with the value as *platinum*.
+3. Set up an [Item Discount](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-an-item-discount-promotion) in the **Actions** section as 20% off.
+
+See the following image:
+
+![Creating a Promotion with Custom Attributes](/assets/promotion-example-scenario-1.png)

guides/How-To/promotions-builder/promotion-with-multiple-discount-actions.mdx

@@ -0,0 +1,17 @@
+---
+title: Creating a Promotion with Multiple Discount Actions
+nav_label: Promotion with Multiple Discount Actions
+sidebar_position: 30
+---
+
+**USe Case:** You want to offer 20% off to all shoppers who spend $3000 or more on engagement rings. 
+Additionally, shoppers also receive a 10% discount on the cheapest item from the *Bangles* category.
+
+To set this up in the Promotions Builder:
+
+1. Configure a [Cart condition](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-cart-condition) to check if the subtotal is equal to or greater than $3000.
+2. Add a [Cart Items condition](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-cart-items-condition) specifying the engagement rings category.
+3. Set up an [Cart Discount](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-cart-discount-promotion) in the **Actions** section for 20% off on engagement rings.
+4. Configure [BXGY](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-bxgy-promotion) and create another item discount to apply a 10% discount on the cheapest item from the *Bangles* category.
+
+![Creating a Promotion with Multiple Discount Actions](/assets/promotion-example-scenario-3.png)

guides/How-To/promotions-builder/quantity-limit-discount.mdx

@@ -0,0 +1,17 @@
+---
+title: Creating a Promotion with the Maximum Item Quantity Limitation
+nav_label: Quantity Limit Discount
+sidebar_position: 50
+---
+
+**Use Case:** You want to encourage shoppers purchase two of the same items, by offering a 50% discount on one of them.
+
+To set this up in the Promotions Builder:
+
+1. Specify the required quantity of SKUs that need to be purchased as part of the condition. This can be done by configuring the **items quantity** parameter in [Create Cart Condition](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-cart-condition).
+2. Configure a [Cart Item condition](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-cart-items-condition) to target the desired item.
+3. Create a [BXGY discount](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-bxgy-promotion) in the **Actions** section for a 50% discount with a maximum quantity limit for the discount to apply to.
+
+By implementing this promotion, shoppers could be encouraged to purchase two of the same items, with one item being discounted by 50%.
+
+![Creating a Promotion with the Maximum Item Quantity Limitation](/assets/promotion-example-scenario-5.png)

guides/How-To/promotions-builder/shipping-group-promo.mdx

@@ -0,0 +1,30 @@
+---
+title: Shipping Group Promotions
+nav_label: Shipping Group Promotions
+sidebar_position: 100
+---
+
+**Use Case:** You want to offer free ground shipping on orders of $100 or more, or 50% off express shipping, based on the shopper's selected shipping method.
+
+### Steps
+
+1. **Add a Cart Condition:**
+   - In the **Conditions** section, set a **Cart Condition** where the cart subtotal is equal to or greater than $100.
+
+2. **Select the Shipping Discount in Actions:**
+   - Go to the **Actions** section of the Promotions Builder and select **Shipping**.
+
+3. **Set Discount Type and Value:**
+   - Choose either a **percentage** or a **fixed amount** discount.
+   - Enter the discount value in the **Value** field. For example, set to **100%** for free ground shipping or **50%** for half-price express shipping.
+
+4. **Specify Targeted Shipping Type (Optional):**
+   - By default, the action will apply to all shipping methods. If you want the discount to apply only to specific shipping methods, select **+ more options**.
+   - Check the box for **Apply discount to** and enter the shipping method values that match the targeted cart’s `shipping type` value (e.g., “usps_ground”).
+   - Press **Enter** after each value, and add additional shipping types as needed.
+
+5. **Repeat Steps 2–4 to Add a Second Action, Then Save:**
+   - Follow these steps to add a second shipping method discount option, with a `shipping method` value entry of "fedex_1day."
+   - Click **Done** to save and apply the promotion settings.
+
+![Shipping Group Promotion](/assets/how-to-guide-screenshots/shipping-discount-promo-scenario.png)

guides/How-To/promotions-builder/tiered-promotion.mdx

@@ -0,0 +1,29 @@
+---
+title: Creating a Tiered Promotions
+nav_label: Tiered Promotion
+sidebar_position: 40
+---
+
+**Use Case:** You want to provide shoppers with various cart subtotal tiers to receive different discounts. Shoppers need one coupon code to trigger the various tiers. For example, use the coupon code *summer2024*.
+
+The shoppers need to:
+- Spend equal to or less than $100 and get 10% off the cart subtotal.
+- Spend between $100 and $500 and get 20% off the cart subtotal.
+
+To set this up in the Promotions Builder:
+
+1. Configure the first promotion for the $100 tier:
+    1. Add a [Cart condition](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-cart-condition) to check if the subtotal is less than $100.
+    1. Set up a [Cart Discount](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-cart-discount-promotion) for 10% off the cart subtotal.
+    1. Use the coupon code *summer2024* to trigger this promotion.
+
+1. Configure the second promotion for the $100 to $500 tier:
+    1. Add a [Cart condition](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-cart-condition) to check if the subtotal is greater than $100 and less than or equal to $500.
+    1. Set up a [Cart Discount](/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder#creating-a-cart-discount-promotion) for 20% off the cart subtotal.
+    1. Again, use the coupon code *summer2024* to trigger this promotion.
+
+The following image shows an example of the $100 tier promotion:
+![Creating a Tiered Promotions](/assets/promotion-example-scenario-4-1.png)
+
+The following image shows an example of the $100 to $500 tier promotion:
+![Creating a Tiered Promotions](/assets/promotion-example-scenario-4-2.png)

guides/How-To/promotions-builder/use-flows-with-promo-builder.mdx

@@ -0,0 +1,35 @@
+---
+title: Using Flows to Create Promotion Rules & Conditions Messaging
+nav_label: Using Flows to Create Promotion Rule Messaging
+sidebar_position: 110
+---
+
+**Use Case:** You want to create custom messaging for your promotion to make promotion restriction rules and conditions visible in your storefront.
+
+In this scenario, you'll create a custom flow and corresponding fields to be visible when you create a new promotion using the Promotions Builder.
+
+To set this up, you'll first need to create your flow, then enter the messaging content in your promotion.
+
+### Creating the Flow
+
+1. **Create a Flow**: Follow the steps to [create a flow](docs/commerce-manager/flows/flows.mdx) and create a new flow for your promotion rule messaging.
+2. **Enter Slug**: In the `slug` field for your flow settings, enter **rule-promotions**. This step is important as it allows your flow fields to appear in your promotion configuration area.
+3. **Enable your Flow**: After you add a **description**, check the **Enabled** checkbox to activate your flow, then click **Save**.
+4. **Add Fields to the Flow**:
+    - Select the flow from the list to open its details.
+    - Click **+New Field** to add fields necessary for your promotion rule messaging, such as eligibility requirements, shipping restrictions, exclusions, or usage limits.
+    - Choose the appropriate Field Type (e.g., String for message content).
+    - Configure field settings, including name, slug, description, whether it is required, and any default values or validation rules.
+
+After configuring each field, click **Save** to add it to the flow.
+
+![configuring a flow and flow fields for use in promo builder](/assets/how-to-guide-screenshots/flow-field-promo-builder.png)
+
+### Adding Messaging to a Promotion in Promotion Builder
+
+1. **Create a Promotion**: Follow the steps for creating a new promotion in the Promotions Builder. For this example, we'll create a [Buy X, Get Y](guides/How-To/Promotions Builder/buy-x-get-y-promotion.mdx) promotion.
+2. **Save your Promotion**: Once all promotion details, conditions, and actions have been added, **save** your promotion. For this example, we configure that a cart must contain a product from both the "Moisturizer" and "Cleanser" hierarchy nodes and set up a **Buy X, Get Y** action where the shopper gets 50% off the cheapest treatment added to their cart.
+3. **Expand the Custom Fields**: To add your promotion rule messaging, expand the **Custom Fields** box to view the flow you have just created.
+4. **Enter Promotion Rule Messaging**: Add your messaging in the corresponding string field, then save your promotion.
+
+![configuring custom fields from promo builder in commerce manager](/assets/how-to-guide-screenshots/promo-builder-custom-fields.png)