braze-inc · bre-fitzgerald · Mar 5, 2026 · Feb 23, 2026 · Feb 23, 2026 · Feb 23, 2026
diff --git a/_docs/_contributing/content_management.md b/_docs/_contributing/content_management.md
@@ -26,7 +26,7 @@ As a contributor, you'll primarily work within the following directories.
 
 | Directory                                                                     | Description                                                                                                                                                                                                                                                                                                                       |
 |-------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| [`_docs`](https://github.com/braze-inc/braze-docs/tree/develop/_docs)         | Contains all the written content for Braze Docs as text files written in Markdown. Text files are organized into directories and subdirectories mirroring the docs site, such as `_api` for the [API section]({{site.baseurl}}/api/home) and `user_guide` for the [User Guide section]({{site.baseurl}}/user_guide/introduction). |
+| [`_docs`](https://github.com/braze-inc/braze-docs/tree/develop/_docs)         | Contains all the written content for Braze Docs as text files written in Markdown. Text files are organized into directories and subdirectories mirroring the docs site, such as `_api` for the [API section]({{site.baseurl}}/api/home) and `user_guide` for the [User Guide section]({{site.baseurl}}/user_guide/home). |
 | [`_includes`](https://github.com/braze-inc/braze-docs/tree/develop/_includes) | Contains text files (called "includes") that can be reused in any file within the `_docs` directory. Typically, includes are short, modular pieces of content that don't use standard formatting. The files stored in this location are important for [content reuse](#content-reuse).                                            |
 | [`assets`](https://github.com/braze-inc/braze-docs/tree/develop/assets)       | Contains all the images for Braze Docs. Any text file in the `_docs` or `_includes` directory can link to this directory to display an image on its page.                                                                                                                                                                         |
 {: .reset-td-br-1 .reset-td-br-2 role="presentation" }
@@ -123,7 +123,7 @@ Braze Docs is organized into [primary sections](#primary-sections) and [subsecti
 The primary sections on Braze Docs are:
 
 - [Braze Docs Home]({{site.baseurl}})
-- [User Guide]({{site.baseurl}}/user_guide/introduction)
+- [User Guide]({{site.baseurl}}/user_guide/home)
 - [Developer Guide]({{site.baseurl}}/developer_guide/home)
 - [Braze API Guide]({{site.baseurl}}/api/home)
 - [Technology Partners]({{site.baseurl}}/partners/home)

diff --git a/_docs/_contributing/content_management/reusing_content.md b/_docs/_contributing/content_management/reusing_content.md
@@ -41,7 +41,7 @@ As a contributor, you'll primarily work within the following directories.
 
 | Directory                                                                     | Description                                                                                                                                                                                                                                                                                                                       |
 |-------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| [`_docs`](https://github.com/braze-inc/braze-docs/tree/develop/_docs)         | Contains all the written content for Braze Docs as text files written in Markdown. Text files are organized into directories and subdirectories mirroring the docs site, such as `_api` for the [API section]({{site.baseurl}}/api/home) and `user_guide` for the [User Guide section]({{site.baseurl}}/user_guide/introduction). |
+| [`_docs`](https://github.com/braze-inc/braze-docs/tree/develop/_docs)         | Contains all the written content for Braze Docs as text files written in Markdown. Text files are organized into directories and subdirectories mirroring the docs site, such as `_api` for the [API section]({{site.baseurl}}/api/home) and `user_guide` for the [User Guide section]({{site.baseurl}}/user_guide/home). |
 | [`_includes`](https://github.com/braze-inc/braze-docs/tree/develop/_includes) | Contains text files (called "includes") that can be reused in any file within the `_docs` directory. Typically, includes are short, modular pieces of content that don't use standard formatting. The files stored in this location are important for [content reuse](#content-reuse).                                            |
 | [`assets`](https://github.com/braze-inc/braze-docs/tree/develop/assets)       | Contains all the images for Braze Docs. Any text file in the `_docs` or `_includes` directory can link to this directory to display an image on its page.                                                                                                                                                                         |
 {: .reset-td-br-1 .reset-td-br-2 role="presentation" }

diff --git a/_docs/_docs_pages/index.md b/_docs/_docs_pages/index.md
@@ -18,7 +18,7 @@ doc_menu_list:
   - name: User Guide
     bg_color: '#3accdd'
     image: /assets/img/braze_icons/users-01.svg
-    link: /docs/user_guide/introduction/
+    link: /docs/user_guide/home/
     description: "Learn how to use the Braze platform to foster a more impactful customer experience."
   - name: Developer Guide
     bg_color: '#f7918e'

diff --git a/_docs/_docs_pages/user_guide.md b/_docs/_docs_pages/user_guide.md
@@ -2,6 +2,6 @@
 config_only: true
 noindex: true
 layout: redirect
-redirect_to: /docs/user_guide/introduction/
+redirect_to: /docs/user_guide/home/
 permalink: user_guide/
 ---
@@ -1340,7 +1340,7 @@ var ticket_lookuptable = {
   'Label': '* What can we help you with?',
   'SelectDefault': 'Select a topic...',
   'LinksTitle': ['Marketer documentation','Developer documentation','Marketer troubleshooting guide','Frequently Asked Questions'],
-  'Links': ['{{site.baseurl}}/user_guide/introduction/','{{site.baseurl}}/developer_guide/platform_wide/platform_features/','{{site.baseurl}}/help/home/','{{site.baseurl}}/help/faqs/'],
+  'Links': ['{{site.baseurl}}/user_guide/home/','{{site.baseurl}}/developer_guide/platform_wide/platform_features/','{{site.baseurl}}/help/home/','{{site.baseurl}}/help/faqs/'],
   'SelectOption': {
     'Technical Issue': {
       'Label': '* Category',
@@ -1619,7 +1619,7 @@ var ticket_lookuptable = {
                 'Email' : {
                   'ShowSubmit': true,
                   'LinksTitle': ['Create an Email Campaign with the Drag-And-Drop Editor','Create an Email Campaign with the HTML Editor'],
-                  'Links' : ['{{site.baseurl}}/user_guide/message_building_by_channel/email/drag_and_drop/overview/','{{site.baseurl}}/user_guide/message_building_by_channel/email/html_editor/creating_an_email_campaign/']
+                  'Links' : ['{{site.baseurl}}/user_guide/message_building_by_channel/email/drag_and_drop/','{{site.baseurl}}/user_guide/message_building_by_channel/email/html_editor/']
                 },
                 'Push' : {
                   'ShowSubmit': true,
@@ -1643,8 +1643,8 @@ var ticket_lookuptable = {
                 },
                 'SMS and MMS' : {
                   'ShowSubmit': true,
-                  'LinksTitle': ['Create an SMS Campaign','Create an MMS Campaign'],
-                  'Links' : ['{{site.baseurl}}/user_guide/message_building_by_channel/sms/campaign/create/','{{site.baseurl}}/user_guide/message_building_by_channel/sms/mms/create/']
+                  'LinksTitle': ['Create an SMS, MMS, or RCS Message'],
+                  'Links' : ['{{site.baseurl}}/user_guide/channels/sms_mms_and_rcs/create/']
                 },
                 'WhatsApp' : {
                   'ShowSubmit': true,

diff --git a/_docs/_partners/data_and_analytics/loyalty/punchh/punchh.md b/_docs/_partners/data_and_analytics/loyalty/punchh/punchh.md
@@ -163,7 +163,7 @@ Braze can add users to a Punchh segment through webhooks utilizing Punchh Custom
 
 2. Create a webhook campaign in Braze using the Punchh endpoint for adding a user to a custom segment as the webhook URL. Here, you can provide the `custom_segment_id` pulled from the URL and `user_id` as key-value pairs.<br><br>![]({% image_buster /assets/img/punchh/punchh4.png %})<br><br>
 
-3. This webhook can be set up as a singular campaign or as a step within a Canvas. Alternatively, if the webhook adding users to this specific Punchh segment will be used in multiple campaigns or Canvases, it can be set up as a [template]({{site.baseurl}}/user_guide/message_building_by_channel/webhooks/webhook_template#creating-a-webhook-template).<br><br>
+3. This webhook can be set up as a singular campaign or as a step within a Canvas. Alternatively, if the webhook adding users to this specific Punchh segment will be used in multiple campaigns or Canvases, it can be set up as a [template]({{site.baseurl}}/user_guide/messaging/templates/webhook_templates/).<br><br>
 The `user_id` key within the webhook maps to the Punchh user ID. This identifier will need to be added to all webhooks created in Braze to add users to a Punchh custom segment. The `punch_user_id` custom attribute can be dynamically populated as the value for the `user_id` key using [Liquid]({{site.baseurl}}/user_guide/personalization_and_dynamic_content/liquid/using_liquid/#pre-formatted-variables). You can insert the `punchh_user_id` custom attribute variable using the blue "plus" icon located on the top-right of any templated text field.<br><br>![]({% image_buster /assets/img/punchh/update3.png %}){: style="max-width:65%;"}<br><br>![]({% image_buster /assets/img/punchh/update4.png %}){: style="max-width:65%;"}<br><br>
 
 4. After the webhook is saved, it can be used to sync users, as shown below. For example, 136 guests would be added to the Punch custom segment when this Braze webhook campaign is launched.<br><br>![An example of syncing users using the saved webhook due to Braze and Punchh integration.]({% image_buster /assets/img/punchh/punchh6.png %})

diff --git a/_docs/_partners/ecommerce/shopify/discount_codes.md b/_docs/_partners/ecommerce/shopify/discount_codes.md
@@ -8,7 +8,7 @@ description: "This reference article covers a community-submitted use case of us
 
 # Send unique discount codes through Shopify
 
-> This community-submitted use case shows how to use Braze [promotion codes]({{site.baseurl}}/user_guide/personalization_and_dynamic_content/promotion_codes/) with the Shopify Bulk Discount Code Bot to generate unique discount codes for your campaigns and Canvases. Unique discount codes help avoid the exploitation of generic promotion codes.
+> This community-submitted use case shows how to use Braze [promotion codes]({{site.baseurl}}/user_guide/messaging/design_and_edit/personalize/sources/promotion_codes/) with the Shopify Bulk Discount Code Bot to generate unique discount codes for your campaigns and Canvases. Unique discount codes help avoid the exploitation of generic promotion codes.
 
 {% alert important %}
 This is a community-submitted integration and isn’t directly supported by Braze. The Bulk Discount Code Bot is directly supported by Shopify. Only Braze promotion codes are supported by Braze. 
@@ -42,7 +42,7 @@ In the CSV file, delete row 1 to remove the column header “Promo”. This will
 
 ### Step 3: Add your discount codes to Braze
 
-In Braze, go to **Data Settings** > **Promotion Codes** > **Create Promotion Code List** and [configure your discount codes list]({{site.baseurl}}/user_guide/personalization_and_dynamic_content/promotion_codes/#creating-a-promotion-code-list). Make sure you match the expiration date that was configured by the Bulk Discounts Code Bot.
+In Braze, go to **Data Settings** > **Promotion Codes** > **Create Promotion Code List** and [configure your discount codes list]({{site.baseurl}}/user_guide/messaging/design_and_edit/personalize/sources/promotion_codes/#creating-a-promotion-code-list). Make sure you match the expiration date that was configured by the Bulk Discounts Code Bot.
 
 Then, upload your CSV file and select **Save List**.
 

diff --git a/.../message_personalization/dynamic_content/visual_and_interactive_content/judo.md b/.../message_personalization/dynamic_content/visual_and_interactive_content/judo.md
@@ -80,7 +80,7 @@ Note that this will not be displayed in production on your device as Judo will r
 ### Step 2: Set a key-value pair for Judo
 ![This image shows the one key-value pair needed for this integration with the "key" being "judo-experience", and the "value" being your Judo link.]({% image_buster /assets/img/judo/braze-campaign-extras-judo-experience.png %}){: style="float:right;max-width:50%;margin-left:15px;"}
 
-Set a [custom key-value pair]({{site.baseurl}}/user_guide/personalization_and_dynamic_content/key_value_pairs/) on the campaign with a key of `judo-experience`. Provide the URL of the Judo Experience you'd like to show here. The Judo-Braze integration library will then detect this key-value pair in the handler and use it to inject your Judo Experience in place of the standard Braze in-app message UI.
+Set a [custom key-value pair]({{site.baseurl}}/user_guide/messaging/design_and_edit/personalize/sources/key_value_pairs/) on the campaign with a key of `judo-experience`. Provide the URL of the Judo Experience you'd like to show here. The Judo-Braze integration library will then detect this key-value pair in the handler and use it to inject your Judo Experience in place of the standard Braze in-app message UI.
 <br><br>
 ### Step 3: Finishing the campaign
 

diff --git a/_docs/_releases/2020/july.md b/_docs/_releases/2020/july.md
@@ -9,7 +9,7 @@ description: "This article contains release notes for July 2020."
 
 ## Promotion codes
 
-Using Liquid, you can have your messages pull from a list of [promotion codes]({{site.baseurl}}/user_guide/personalization_and_dynamic_content/promotion_codes/#promotion-codes) you upload. This feature offers expiry dates of up to six months and supports u to 20MM individual codes per list.
+Using Liquid, you can have your messages pull from a list of [promotion codes]({{site.baseurl}}/user_guide/messaging/design_and_edit/personalize/sources/promotion_codes/#promotion-codes) you upload. This feature offers expiry dates of up to six months and supports u to 20MM individual codes per list.
 
 ## Variant retention report
 

diff --git a/_docs/_releases/2022/11_15_22.md b/_docs/_releases/2022/11_15_22.md
@@ -24,7 +24,7 @@ The existing Text block is being deprecated, but any existing email that has a T
 
 ### Dark Mode Preview
 
-When [previewing and testing your emails]({{site.baseurl}}/user_guide/message_building_by_channel/email/html_editor/creating_an_email_campaign/#step-3b-preview-and-test-your-message) in the drag-and-drop editor, you can now turn on **Dark Mode Preview** to see what your email looks like for dark mode users.
+When [previewing and testing your emails]({{site.baseurl}}/user_guide/message_building_by_channel/email/html_editor/#step-3b-preview-and-test-your-message) in the drag-and-drop editor, you can now turn on **Dark Mode Preview** to see what your email looks like for dark mode users.
 
 ## Winning Path early access
 

diff --git a/_docs/_releases/2022/12_13_22.md b/_docs/_releases/2022/12_13_22.md
@@ -15,7 +15,7 @@ News Feed is being deprecated. Braze recommends that customers who use our News
 Use the [Braze API Catalogs endpoints]({{site.baseurl}}/api/endpoints/catalogs) to add, edit, and manage your [catalogs]({{site.baseurl}}/user_guide/personalization_and_dynamic_content/catalogs) and catalog item details. You can use the asynchronous catalog endpoints to make bulk changes to your catalog.
 
 ## HTML attributes for links in the Drag & Drop Editor for Email
-You can now [add HTML attributes]({{site.baseurl}}/user_guide/message_building_by_channel/email/drag_and_drop/overview/#creative-details/) to any URL within the `Image`, `Button`, or `Text` editor blocks in the Drag & Drop Editor for Email. With custom attributes, you can easily append additional information to HTML tags in emails. This can be especially useful for message personalization, segmentation, and styling. 
+You can now [add HTML attributes]({{site.baseurl}}/user_guide/message_building_by_channel/email/drag_and_drop/#creative-details/) to any URL within the `Image`, `Button`, or `Text` editor blocks in the Drag & Drop Editor for Email. With custom attributes, you can easily append additional information to HTML tags in emails. This can be especially useful for message personalization, segmentation, and styling. 
 
 ## Show Heatmap toggle
 You can now use the [Show Heatmap toggle]({{site.baseurl}}/user_guide/message_building_by_channel/email/reporting_and_analytics/email_reporting#heatmaps) to bring up a visual view of your **Message Analytics** that shows the overall frequency and location of clicks within the lifespan of the email campaign. You can also download a copy of your heatmaps for future reference.

diff --git a/_docs/_releases/2022/5_31_22.md b/_docs/_releases/2022/5_31_22.md
@@ -15,7 +15,7 @@ With Inbox Vision, you can check that your drag & drop email campaigns are align
 
 ## Updated HTML engine
 
-The underlying engine that produces HTML from the Drag & Drop Editor has been optimized and updated, resulting in benefits related to HTML file compression and rendering. For more details on the updates, check out [Updated HTML engine]({{site.baseurl}}/user_guide/message_building_by_channel/email/drag_and_drop/overview/#updated-html-engine/).
+The underlying engine that produces HTML from the Drag & Drop Editor has been optimized and updated, resulting in benefits related to HTML file compression and rendering. For more details on the updates, check out [Updated HTML engine]({{site.baseurl}}/user_guide/message_building_by_channel/email/drag_and_drop/#updated-html-engine/).
 
 ## Updated keyword category-specific retargeting
 

diff --git a/_docs/_releases/2023/7_25_23.md b/_docs/_releases/2023/7_25_23.md
@@ -29,7 +29,7 @@ Using the [`/users/track`]({{site.baseurl}}/api/endpoints/user_data/post_user_tr
 {% multi_lang_include early_access_beta_alert.md feature='This feature' %}
 
 ## Whitespace after email preheader 
-The new **Add whitespace after preheader** checkbox hides the text or HTML of the email body in the email preheader. Learn more about adding email headers in [Creating an email]({{site.baseurl}}/user_guide/message_building_by_channel/email/html_editor/creating_an_email_campaign/#step-3-compose-your-email).
+The new **Add whitespace after preheader** checkbox hides the text or HTML of the email body in the email preheader. Learn more about adding email headers in [Creating an email]({{site.baseurl}}/user_guide/message_building_by_channel/email/html_editor/#step-3-compose-your-email).
 
 ## SDK updates
 

diff --git a/_docs/_releases/2025/10_14_25.md b/_docs/_releases/2025/10_14_25.md
@@ -60,7 +60,7 @@ Sync Canvas triggers using Cloud Data Ingestion for [zero-copy personalization](
 
 {% multi_lang_include release_type.md release="Early access" %}
 
-You can [create context variable filters]({{site.baseurl}}/user_guide/engagement_tools/canvas/create_a_canvas/context_variables/#context-variable-filters) that use previously-declared context variables in [Audience Paths]({{site.baseurl}}/user_guide/engagement_tools/canvas/canvas_components/audience_paths) and [Decision Split]({{site.baseurl}}/user_guide/engagement_tools/canvas/canvas_components/decision_split) steps.
+You can [create context variable filters]({{site.baseurl}}/user_guide/messaging/design_and_edit/personalize/sources/context_variables/#context-variable-filters) that use previously-declared context variables in [Audience Paths]({{site.baseurl}}/user_guide/engagement_tools/canvas/canvas_components/audience_paths) and [Decision Split]({{site.baseurl}}/user_guide/engagement_tools/canvas/canvas_components/decision_split) steps.
 
 ## Unlocking creativity