diff --git a/changelog/2024/2024-10-30-changelog.md b/changelog/2024/2024-10-30-changelog.md
new file mode 100644
index 00000000..d550a815
--- /dev/null
+++ b/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).
+
diff --git a/changelog/2024/2024-10-31-changelog.md b/changelog/2024/2024-10-31-changelog.md
new file mode 100644
index 00000000..2be550c4
--- /dev/null
+++ b/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.
\ No newline at end of file
diff --git a/changelog/2024/2024-11-05-changelog.md b/changelog/2024/2024-11-05-changelog.md
new file mode 100644
index 00000000..3786ef18
--- /dev/null
+++ b/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)
+
diff --git a/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder.mdx b/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder.mdx
index 5335fe88..d5c07afc 100644
--- a/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder.mdx
+++ b/docs/commerce-manager/promotions-builder/creating-a-promotion-in-promotions-builder.mdx
@@ -14,7 +14,7 @@ sidebar_position: 1
 1. Select the end date in the **End Date** field.
 1. Enter the priority number in the **Assign a priority** field. This field determines the order of the stackable promotions that can be applied simultaneously. Each promotion must have a unique priority number. If you assign a priority number that is already in use by another promotion, you will receive an error message.
 
-    This step is optional. If a priority is not assigned, promotions will be applied in the order of their creation dates, with the newest promotions applied first and discounted prices calculated against any previously-discounted item prices.
+This step is optional. If a priority is not assigned, promotions will be applied in the order of their creation dates, with the newest promotions applied first and discounted prices calculated against any previously-discounted item prices.
 1. Select the **Enabled** toggle to activate the promotion. It is disabled by default.
 1. Select the **Stackable** toggle to allow multiple promotions to be stacked. This option is disabled by default and controls whether a promotion can be stacked with others. If this toggle is not enabled, no other promotion can stack on top. The promotion with the highest priority will take precedence. See [Stacking and Prioritizing](/docs/commerce-manager/promotions-builder/#stacking-and-prioritizing-multiple-promotions)
 1. (Optional) Select the **Coupon-driven** checkbox to manually [create a single code](/docs/commerce-manager/promotions-builder/creating-promotion-codes#creating-a-single-code). If not selected, a promotion code is automatically generated for you.
@@ -28,26 +28,26 @@ In the **Create your rules** section, do the following:
 1. Select a currency for the promotion in the **Currency** field.
 1. Choose eligible catalogs for the promotion in the **Catalog** field.
 1. Under **Conditions**, select **all** to apply all conditions.
-    - **Cart**: Configure the promotion by setting either a minimum cart subtotal or quantity of cart items. You can also add conditions to exclude certain items from the cart eligibility. See [Creating a Cart Condition](#creating-a-cart-condition).
-    - **Cart Items**: Specify the desired product quantity or value. You can also add exclusions that will not contribute to the cart eligibility. See [Creating a Cart Items Condition](#creating-a-cart-items-condition).
-    - **Custom Attributes**: Define conditions based on custom attributes. See [Adding Cart Custom Attributes](#adding-cart-custom-attributes).
+ - **Cart**: Configure the promotion by setting either a minimum cart subtotal or quantity of cart items. You can also add conditions to exclude certain items from the cart eligibility. See [Creating a Cart Condition](#creating-a-cart-condition).
+ - **Cart Items**: Specify the desired product quantity or value. You can also add exclusions that will not contribute to the cart eligibility. See [Creating a Cart Items Condition](#creating-a-cart-items-condition).
+ - **Custom Attributes**: Define conditions based on custom attributes. See [Adding Cart Custom Attributes](#adding-cart-custom-attributes).
 
 ### Creating a Cart Condition
 
 1. Select **Cart** in the **Conditions** section.
 1. Set the basic conditions:
-    1. Choose either **Subtotal** or **Items quantity** to specify a condition for the cart.
-    1. Select an operator from the following options:
-        - **is equal to**
-        - **is greater than**
-        - **is equal or greater than**
-        - **is less than**
-        - **is equal or less than**
-
-    1. If you selected **Subtotal**, enter the desired amount. This value is used to determine the subtotal of the cart, based on the operator selected in the previous step. For example, if you selected the **is greater than** operator, the  **Subtotal** must exceed the specified amount.
-    1. If you selected **Items quantity**, enter the required quantity.
-
-    You can add multiple conditions according to your business requirements.
+ 1. Choose either **Subtotal** or **Items quantity** to specify a condition for the cart.
+ 1. Select an operator from the following options:
+ - **is equal to**
+ - **is greater than**
+ - **is equal or greater than**
+ - **is less than**
+ - **is equal or less than**
+
+ 1. If you selected **Subtotal**, enter the desired amount. This value is used to determine the subtotal of the cart, based on the operator selected in the previous step. For example, if you selected the **is greater than** operator, the  **Subtotal** must exceed the specified amount.
+ 1. If you selected **Items quantity**, enter the required quantity.
+
+You can add multiple conditions according to your business requirements.
 1. Define exclusions. To exclude items from the promotion, either select **copy exclusions from actions**, or select **Add an exclusion** and then make changes as needed. See [Adding Exclusions](#adding-exclusions).
 1. Click **Done** to apply the conditions.
 
@@ -56,9 +56,9 @@ In the **Create your rules** section, do the following:
 1. Select **Cart Items** in the **Conditions** section.
 1. Choose **is** to include cart items in the promotion.
 1. Specify the type of cart items:
-    - **product**: Select the **+** icon. Then, in the **Select Product** window either select a product from the list or include a custom SKU in the **Add Custom SKU** field. For instructions on searching for products in the **Select Product** window, see [Searching for Products](#searching-for-products).
-    - **node/hierarchy (category)**: Select the **+** icon and select the hierarchy checkbox. Then, click the hierarchy if you want to add nodes to your promotion conditions.
-    - **attribute**: Select the template from the list, select the attribute, and then set the value for the selected attribute.
+ - **product**: Select the **+** icon. Then, in the **Select Product** window either select a product from the list or include a custom SKU in the **Add Custom SKU** field. For instructions on searching for products in the **Select Product** window, see [Searching for Products](#searching-for-products).
+ - **node/hierarchy (category)**: Select the **+** icon and select the hierarchy checkbox. Then, click the hierarchy if you want to add nodes to your promotion conditions.
+ - **attribute**: Select the template from the list, select the attribute, and then set the value for the selected attribute.
 1. Define exclusions. To exclude items from the promotion, either select **copy exclusions from actions**, or select **Add an exclusion** and then make changes as needed. See [Adding Exclusions](#adding-exclusions)..
 
 1. Click **Done** to apply the conditions.
@@ -76,10 +76,10 @@ For example, you may want to add a custom attribute for a customer’s membershi
 1. Select **Custom Attributes** in the **conditions** section.
 1. Enter the name of your attribute key. For example, you can enter *membership level*.
 1. Choose one of the following types depending on your attribute key.
-    - **String**
-    - **Float**
-    - **Integer**
-    - **Boolean**
+ - **String**
+ - **Float**
+ - **Integer**
+ - **Boolean**
 1. Enter the specific value depending on your attribute. For example, *gold* or *silver*.
 1. Click **Done** to apply the changes.
 
@@ -133,12 +133,12 @@ To create a BXGY promotion, do the following:
 1. If you selected **amount**, specify the amount for the promotion.
 1. Select **all**, **cheapest**, or **most expensive** items in the cart to qualify for the promotion.
 1. Specify the type of items to include in the promotion from the following options:
-    - **product**: Select the **+** icon. Then, in the **Select Product** window either select a product from the list or include a custom SKU in the **Add Custom SKU** field. For instructions on searching for products in the **Select Product** window, see [Searching for Products](#searching-for-products).
-    - **node/hierarchy (category)**: Select the **+** icon and select the hierarchy checkbox. Then, click the hierarchy if you want to add nodes to your promotion.
-    - **Attribute**: To add the attribute, do the following:
-        1. Select the template from the list.
-        1. Select the attribute from the list.
-        1. Select the value from the list corresponding to the chosen attributes.
+ - **product**: Select the **+** icon. Then, in the **Select Product** window either select a product from the list or include a custom SKU in the **Add Custom SKU** field. For instructions on searching for products in the **Select Product** window, see [Searching for Products](#searching-for-products).
+ - **node/hierarchy (category)**: Select the **+** icon and select the hierarchy checkbox. Then, click the hierarchy if you want to add nodes to your promotion.
+ - **Attribute**: To add the attribute, do the following:
+  1. Select the template from the list.
+  1. Select the attribute from the list.
+  1. Select the value from the list corresponding to the chosen attributes.
 1. Define exclusions. To exclude items from the promotion, either select **copy exclusions from conditions**, or select **Add an exclusion** and then make changes as needed. See [Adding Exclusions](#adding-exclusions).
 1. Click **+ more options**.
 1. Enter the value to assign a maximum allowed discount for the promotion. This field is shown only if you choose **percentage** as your discount type.
@@ -158,7 +158,7 @@ To create a shipping discount promotion, do the following:
 1. (Optional) If there is targeted shipping type for discount, then select **+ more options**.
 1. Check the checkbox **Apply discount to**.
 1. Enter the shipping type value that matches targeted cart shipping group `shipping_type` value and hit Enter. For example, "fedex", "UPS".
-    - You can add more than one.
+ - You can add more than one.
 1. Click **Done** to apply the changes.
 
 ## Adding Exclusions
@@ -167,9 +167,9 @@ Exclusions allow you to exclude specific items from the promotion, ensuring they
 
 1. Select **Add an exclusion**.
 1. Choose one of the following exclusion types:
-    -  **product**: Enter the values directly or select **view list**. In the **Select Product** window, either choose a product from the list or enter a custom SKU. in the **Add Custom SKU** field. For instructions on searching for products in the **Select Product** window, see [Searching for Products](#searching-for-products).
-    -  **node/hierarchy (category)**: Either enter the unique identifiers directly or select **view list**, then select the checkboxes for the desired nodes/hierarchies(categories).
-    - **attribute**: Select the template from the list, choose the attribute, and then set the value for the selected attribute.
+ -  **product**: Enter the values directly or select **view list**. In the **Select Product** window, either choose a product from the list or enter a custom SKU. in the **Add Custom SKU** field. For instructions on searching for products in the **Select Product** window, see [Searching for Products](#searching-for-products).
+ -  **node/hierarchy (category)**: Either enter the unique identifiers directly or select **view list**, then select the checkboxes for the desired nodes/hierarchies(categories).
+ - **attribute**: Select the template from the list, choose the attribute, and then set the value for the selected attribute.
 1. Click **Done** apply the exclusions.
 
 ## Searching for Products
@@ -177,17 +177,17 @@ Exclusions allow you to exclude specific items from the promotion, ensuring they
 To find specific products to include in your promotion, follow these steps in the **Search Product** Window:
 
 1. In the first column, select the drop-down arrow and choose any one of the following options to search for the product based on:
-    - **SKU**
-    - **Name**
-    - **Slug**
-    - **UPC/EAN**
-    - **MPN**
-    - **Description**
+ - **SKU**
+ - **Name**
+ - **Slug**
+ - **UPC/EAN**
+ - **MPN**
+ - **Description**
 1. In the next column, select the drop-down arrow and choose any one of the following options:
-    - **is**
-    - **is like**
-    - **ends with**
-    - **starts with**
+ - **is**
+ - **is like**
+ - **ends with**
+ - **starts with**
 
 1. In the **Find product** field, enter the desired value based on your selection in the previous steps.
 1. Select **Search**.
@@ -198,11 +198,21 @@ You can duplicate an existing promotion and reuse its details as required in a n
 
 1. Go to **STORE > Promotions Builder**.
 1. To duplicate a promotion, follow one of these steps on the **All Promotions** page:
-    - In the **Actions** column, click the ellipsis next to the promotion's name, then select **Duplicate**.
-    - Open the promotion you want to duplicate, and click **Duplicate** at the bottom of the page.
+ - In the **Actions** column, click the ellipsis next to the promotion's name, then select **Duplicate**.
+ - Open the promotion you want to duplicate, and click **Duplicate** at the bottom of the page.
+
+The duplicated promotion opens. Make the necessary updates, then click **Create Promotion** to save the new promotion.
+
+## Editing Custom Fields in a Promotion
+In order to use custom fields in Promotions Builder, you need to create flows in the store. See [Creating FLows](/docs/commerce-manager/flows) for how to create flows. The **slug** value for promotions builder is **rule-promotions**.
+Once you have created the flows and field, then you can edit the custom fields in promotions builder.
+
+1. In the promotions builder editing page, locate the **Custom Fields** at the bottom of page.
+1. Expand the section.
+1. Edit the fields.
+1. Click **Save** to save the changes.
 
-    The duplicated promotion opens. Make the necessary updates, then click **Create Promotion** to save the new promotion.
 
 ## Related Resources
 
-- [Rule Promotions API](/docs/rule-promotions/overview)
\ No newline at end of file
+- [Rule Promotions API](/docs/promotions-builder/promotions-builder-api/promotions-builder-api-overview)
diff --git a/docusaurus.config.js b/docusaurus.config.js
index 50b0f77e..3fefa875 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -642,7 +642,6 @@ const config = {
       {
         redirects: [
           // /docs/oldDoc -> /docs/newDoc
-          { to: '/docs/api/commerce-extensions', from: '/docs/api/commerce-extensions/commerce-extensions-introduction'},
           { to: '/docs/studio/developers/custom-themes/css-variables', from: '/docs/cx-studio/developers/custom-themes/css-variables'},
           { to: '/docs/studio/Insights/Setting-up-an-AB-Test', from: '/docs/cx-studio/Insights/Setting-up-an-AB-Test'},
           { to: '/changelog/Studio-Release-Notes/2022/Release-145-July-17-2022', from: '/docs/cx-studio/Release-Notes/2022/Release-145-July-17-2022'},
diff --git a/guides/How-To/promotions-builder/_category_.json b/guides/How-To/promotions-builder/_category_.json
new file mode 100644
index 00000000..9343d501
--- /dev/null
+++ b/guides/How-To/promotions-builder/_category_.json
@@ -0,0 +1,4 @@
+{
+    "position": 85,
+    "label": "Promotions Builder"
+}
diff --git a/guides/How-To/promotions-builder/buy-x-get-y-promotion.mdx b/guides/How-To/promotions-builder/buy-x-get-y-promotion.mdx
new file mode 100644
index 00000000..fefab6c6
--- /dev/null
+++ b/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)
\ No newline at end of file
diff --git a/guides/How-To/promotions-builder/excluding-items-from-both-eligibility-and-discount.mdx b/guides/How-To/promotions-builder/excluding-items-from-both-eligibility-and-discount.mdx
new file mode 100644
index 00000000..3af0bddd
--- /dev/null
+++ b/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)
\ No newline at end of file
diff --git a/guides/How-To/promotions-builder/excluding-items-from-discount-eligibility.mdx b/guides/How-To/promotions-builder/excluding-items-from-discount-eligibility.mdx
new file mode 100644
index 00000000..82bf208f
--- /dev/null
+++ b/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)
\ No newline at end of file
diff --git a/guides/How-To/promotions-builder/first-time-shopper-promotion.mdx b/guides/How-To/promotions-builder/first-time-shopper-promotion.mdx
new file mode 100644
index 00000000..2af25e35
--- /dev/null
+++ b/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)
\ No newline at end of file
diff --git a/guides/How-To/promotions-builder/fixed-price-discount.mdx b/guides/How-To/promotions-builder/fixed-price-discount.mdx
new file mode 100644
index 00000000..ebc59795
--- /dev/null
+++ b/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)
\ No newline at end of file
diff --git a/guides/How-To/promotions-builder/index.mdx b/guides/How-To/promotions-builder/index.mdx
new file mode 100644
index 00000000..5b556a0b
--- /dev/null
+++ b/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.
+
diff --git a/guides/How-To/promotions-builder/promotion-with-custom-attributes.mdx b/guides/How-To/promotions-builder/promotion-with-custom-attributes.mdx
new file mode 100644
index 00000000..d16517d6
--- /dev/null
+++ b/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)
\ No newline at end of file
diff --git a/guides/How-To/promotions-builder/promotion-with-multiple-discount-actions.mdx b/guides/How-To/promotions-builder/promotion-with-multiple-discount-actions.mdx
new file mode 100644
index 00000000..6e22a8ad
--- /dev/null
+++ b/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)
\ No newline at end of file
diff --git a/guides/How-To/promotions-builder/quantity-limit-discount.mdx b/guides/How-To/promotions-builder/quantity-limit-discount.mdx
new file mode 100644
index 00000000..38467d15
--- /dev/null
+++ b/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)
\ No newline at end of file
diff --git a/guides/How-To/promotions-builder/shipping-group-promo.mdx b/guides/How-To/promotions-builder/shipping-group-promo.mdx
new file mode 100644
index 00000000..1934ad32
--- /dev/null
+++ b/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)
diff --git a/guides/How-To/promotions-builder/tiered-promotion.mdx b/guides/How-To/promotions-builder/tiered-promotion.mdx
new file mode 100644
index 00000000..6042e74b
--- /dev/null
+++ b/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)
\ No newline at end of file
diff --git a/guides/How-To/promotions-builder/use-flows-with-promo-builder.mdx b/guides/How-To/promotions-builder/use-flows-with-promo-builder.mdx
new file mode 100644
index 00000000..93060983
--- /dev/null
+++ b/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)
diff --git a/src/components/homepage/ui/AbstractBG.tsx b/src/components/homepage/ui/AbstractBG.tsx
index 33a6a266..b2a26ec0 100644
--- a/src/components/homepage/ui/AbstractBG.tsx
+++ b/src/components/homepage/ui/AbstractBG.tsx
@@ -3,7 +3,7 @@ import React from "react";
 export default function () {
   return (
     <div className="z-0 absolute w-[100vw] h-full">
-      <div className="w-full h-full dark:bg-[url('/assets/homepage/blenddark2.webp')] bg-center bg-no-repeat bg-cover"></div>
+      <div className="w-full dark:bg-[url('/assets/homepage/blenddark2.webp')] bg-center bg-no-repeat bg-cover"></div>
     </div>
   );
 }
diff --git a/src/css/custom.css b/src/css/custom.css
index 23059062..a8ccba94 100644
--- a/src/css/custom.css
+++ b/src/css/custom.css
@@ -1384,7 +1384,6 @@ html[data-theme="dark"] .header-github-link:before {
 
 @layer utilities {
   .bg-homepage-gradient {
-    @apply dark:bg-[url('/assets/homepage/blenddark2.webp')] bg-top
   }
 
   .fill-box {
diff --git a/src/pages/index.jsx b/src/pages/index.jsx
index f6bae4ce..38b63ef2 100644
--- a/src/pages/index.jsx
+++ b/src/pages/index.jsx
@@ -17,7 +17,7 @@ export default function Homepage() {
   useLinkedinInsight();
 
   return (
-    <div className="dev-homepage h-full dark:bg-[url('/assets/homepage/blenddark2.webp')] bg-center bg-no-repeat bg-cover bg-white scroll-smooth">
+    <div className="dev-homepage dark:bg-[url('/assets/homepage/dev-site-blend.webp')] bg-cover bg-white scroll-smooth">
       <Layout
         description="Build scalable, API-driven commerce experiences with Elastic Path's headless commerce platform. Unlock seamless integrations and automate operations through our open API, empowering developers to craft innovative shopping experiences."
         wrapperClassName="relative homepage flex flex-col relative"
diff --git a/static/assets/composer/google-merchant-center/diagram.jpg b/static/assets/composer/google-merchant-center/diagram.jpg
new file mode 100644
index 00000000..7064109d
Binary files /dev/null and b/static/assets/composer/google-merchant-center/diagram.jpg differ
diff --git a/static/assets/composer/google-merchant-center/external-local-inventory-ingress-request-openapi.yml b/static/assets/composer/google-merchant-center/external-local-inventory-ingress-request-openapi.yml
new file mode 100644
index 00000000..4ad1163e
--- /dev/null
+++ b/static/assets/composer/google-merchant-center/external-local-inventory-ingress-request-openapi.yml
@@ -0,0 +1,88 @@
+openapi: '3.0.3'
+info:
+  title: Elastic Path Local Inventory Feed
+  description: An asynchronous API to ingest local inventory records from a remote file and publish them to a Google Merchant Center account as a local inventory feed.
+  version: 1.0.0
+  contact:
+    name: Elastic Path Global Services
+    url: 'https://www.elasticpath.com/global-services'
+    email: globalservices@elasticpath.com
+  license:
+    name: MIT
+servers:
+  - url: 'https://hooks.us-east-2.elasticpathintegrations.com'
+    description: (US EAST) Elastic Path Integrations Hub
+  - url: 'https://hooks.eu-west-1.elasticpathintegrations.com'
+    description: (EU WEST) Elastic Path Integrations Hub
+paths:
+  '/trigger/{local-inventory-flow-id}':
+    post:
+      summary: Publish Local Inventory
+      description: The endpoint used to publish local inventory records to a Google Merchant Center account as a local inventory feed.
+      operationId: local-inventory-trigger
+      parameters:
+        - name: local-inventory-flow-id
+          in: path
+          description: 'The flow instance id for the Publish Local Inventory flow.  This can be found in the configuration of the integration, on the Summary tab in the Trigger Details section.'
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              title: Local Inventory Feed Schema
+              description: The schema to submit a local inventory file
+              properties:
+                inventoryFileUrls:
+                  type: array
+                  title: Array of inventory file URLs
+                  description: An array of URLs pointing to the local inventory files.
+                  minItems: 1
+                  items:
+                    type: string
+            examples:
+              Inventory - Single File:
+                value:
+                  inventoryFileUrls:
+                    - "https://my-file-server.com/inventory_20240729.jsonl.gz"
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  executionID:
+                    type: string
+        '400':
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  errors:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        message:
+                          type: string
+                        code:
+                          type: string
+                        detail:
+                          type: object
+        '403':
+          description: Forbidden
+        '500':
+          description: Internal Server Error
+          
+components:
+  securitySchemes:
+    API-Key:
+      type: apiKey
+      name: API-Key
+      in: header
diff --git a/static/assets/composer/google-merchant-center/external-local-inventory-record-schema.json b/static/assets/composer/google-merchant-center/external-local-inventory-record-schema.json
new file mode 100644
index 00000000..c8371552
--- /dev/null
+++ b/static/assets/composer/google-merchant-center/external-local-inventory-record-schema.json
@@ -0,0 +1,33 @@
+{
+  "title": "Google Local Inventory",
+  "type": "object",
+  "properties": {
+    "sku": {
+      "type": "string",
+      "description": "The sku of the product associated with this inventory record."
+    },
+    "storeCode": {
+      "type": "string",
+      "description": "The store code of the store associated with this inventory record."
+    },
+    "price": {
+      "type": "number",
+      "description": "The price of the product associated with this inventory record.",
+      "minimum": 0.01
+    },
+    "salePrice": {
+      "type": "number",
+      "description": "The sale price of the product associated with this inventory record.",
+      "minimum": 0.01
+    },
+    "currency": {
+      "type": "string",
+      "description": "The currency of the prices associated with this inventory record."
+    },
+    "salePriceStartDate": { "type": "string", "format": "date-time" },
+    "salePriceEndDate": { "type": "string", "format": "date-time" },
+    "quantity": { "type": "integer", "minimum": 0 },
+    "instoreLocation": { "type": "string" }
+  },
+  "required": ["sku", "storeCode", "price", "quantity"]
+}
diff --git a/static/assets/homepage/dev-site-blend.webp b/static/assets/homepage/dev-site-blend.webp
new file mode 100644
index 00000000..d379eef9
Binary files /dev/null and b/static/assets/homepage/dev-site-blend.webp differ
diff --git a/static/assets/how-to-guide-screenshots/flow-field-promo-builder.png b/static/assets/how-to-guide-screenshots/flow-field-promo-builder.png
new file mode 100644
index 00000000..6f792c67
Binary files /dev/null and b/static/assets/how-to-guide-screenshots/flow-field-promo-builder.png differ
diff --git a/static/assets/how-to-guide-screenshots/promo-builder-custom-fields.png b/static/assets/how-to-guide-screenshots/promo-builder-custom-fields.png
new file mode 100644
index 00000000..e7df5d7b
Binary files /dev/null and b/static/assets/how-to-guide-screenshots/promo-builder-custom-fields.png differ
diff --git a/static/assets/how-to-guide-screenshots/shipping-discount-promo-scenario.png b/static/assets/how-to-guide-screenshots/shipping-discount-promo-scenario.png
new file mode 100644
index 00000000..7ce615f6
Binary files /dev/null and b/static/assets/how-to-guide-screenshots/shipping-discount-promo-scenario.png differ