Troubleshooting

If you’re having trouble contributing to Braze Docs, review these common issues first. If the issue you’re experiencing isn’t listed, let us know so we can add it here.

Redirect isn’t working

If a redirect you set up in the global redirect file (assets/js/broken_redirect_list.js) isn’t working, double-check your URL string for any uppercase characters. If you find any, convert them to lowercase (even if the corresponding filename in the _docs directory contains uppercase characters).

• before
• after

1
validurls['/docs/hidden/WIP_Partnerships/WIP_Guidelines'] = '/docs/contributing/home/';

1
validurls['/docs/hidden/wip_partnerships/wip_guidelines'] = '/docs/contributing/home/';

Cross-reference link returns a 404

If a cross-reference link on your page (such as [Braze Developer Guide]({{site.baseurl}}/developer_guide/home)) returns a 404 page, check the URL for the following string.

1
%7B%7Bsite.baseurl%7D%7D

A URL containing this string will be similar to the following:

1
https://www.braze.com/docs/user_guide/personalization_and_dynamic_content/connected_content/%7B%7Bsite.baseurl%7D%7D/user_guide/administrative/app_settings/message_activity_log_tab

If you find this string in the URL, one or more of your cross-reference links are surrounded in Liquid raw tags.

• liquid raw tag

Move these tags so that they’re only surrounding the Liquid content you want to display as raw.

• before
• after