Skip to content

Redirecting URLs

Learn how to redirect URLs for pages and page headings on Braze Docs. For general information about URLs, see About content management.

Page URLs always match the directory structure of the Braze Docs repository. When a Markdown file is renamed or moved to a different directory, the original URL will result in a 404 error if a redirect isn’t set up.

Example of a 404 page on Braze Docs.

By setting up URL redirects, you’ll help prevent user bookmarks from breaking.

Prerequisites

If you haven’t already, complete the steps for Contributing to Braze Docs.

Redirecting a page

You can choose to redirect a page’s URL to the Braze Docs home page or a new location.

Open the relevant Markdown file and add the following key-value pair to the YAML front matter. If there’s already a layout key, replace the existing key with the new one.

1
2
3

---
layout: blank_config
---

Your YAML front matter should be similar to the following:

1
2
3
4
5
6

---
nav_title: Customization Guides
config_only: true
layout: blank_config
page_order: 3
---

After you move or rename the relevant Markdown file, navigate to the assets/js/ directory and open the global redirect file.

1
2
3
4

braze-docs
└── assets
    └── js
        └── broken_redirect_list.js

At the of the file, create a redirect on a new line using the following syntax:

1

validurls['REDIRECT_FROM'] = 'REDIRECT_TO';

Replace the following:

Your redirect should be similar to the following:

1

validurls['/docs/user_guide/data_and_analytics/engagement_reports'] = '/docs/user_guide/data_and_analytics/your_reports/engagement_reports';

Redirecting a heading

To redirect the URL for an in-page heading, you’ll use the local_redirect key within the page’s YAML front matter. First, move or rename the relevant Markdown file, the use the following syntax in the page’s YAML front matter:

1
2

local_redirect:
  OLD_HEADING: 'NEW_HEADING_URL'

Replace the following:

Your redirect should be similar to the following:

1
2
3
4
5
6

---
nav_title: Getting started
article_title: Getting started with the Braze SDK
description: "If you're new to the Braze SDK, learn how to get started."
local_redirect:
  building-from-source: '/docs/developer_guide/getting_started/#using-our-install-script'

Testing redirects

You can use bdocs to lists all of the old URLs you set up using a base URL of your choice.

The following example uses the Sage AI rebrand PR.

1
2
3
4
5
6
7
8
9
10
11
12
13

$ git checkout bd-3442
$ ./bdocs redirects https://braze-docs-gtcavota9-braze.vercel.app/
https://braze-docs-gtcavota9-braze.vercel.app/docs/user_guide/sage_ai/
https://braze-docs-gtcavota9-braze.vercel.app/docs/user_guide/sage_ai/predictive_suite/
https://braze-docs-gtcavota9-braze.vercel.app/docs/user_guide/sage_ai/predictive_suite/predictive_churn
https://braze-docs-gtcavota9-braze.vercel.app/docs/user_guide/sage_ai/predictive_suite/predictive_churn/creating_a_churn_prediction/
https://braze-docs-gtcavota9-braze.vercel.app/docs/user_guide/sage_ai/predictive_suite/predictive_churn/prediction_analytics/
https://braze-docs-gtcavota9-braze.vercel.app/docs/user_guide/sage_ai/predictive_suite/predictive_churn/prediction_analytics/prediction_quality/
https://braze-docs-gtcavota9-braze.vercel.app/docs/user_guide/sage_ai/predictive_suite/predictive_churn/messaging_users/
https://braze-docs-gtcavota9-braze.vercel.app/docs/user_guide/sage_ai/predictive_suite/predictive_churn/prediction_faq/
https://braze-docs-gtcavota9-braze.vercel.app/docs/user_guide/sage_ai/predictive_suite/predictive_events/
https://braze-docs-gtcavota9-braze.vercel.app/docs/user_guide/sage_ai/predictive_suite/predictive_events/creating_an_event_prediction/
https://braze-docs-gtcavota9-braze.vercel.app/docs/user_guide/sage_ai/predictive_suite/predictive_events/prediction_analytics/
Github   Edit this page on GitHub
HOW HELPFUL WAS THIS PAGE?
New Stuff!