Managing Page Redirects

List view
Getting started
Managing content in Notion
Understanding Bullet dashboard
Hosting
Membership/Content Gating
Blog
Knowledge base
SEO and metadata
Liquid Syntax
API Documentation
Billing
How to's
Troubleshooting
Themes

Adding redirects for your website links

notion image
  1. Click on “Settings” of your website in the Bullet dashboard and navigate to the “Redirects” section.
  1. Scroll down to the redirects section and fill in your old and new URL details
  1. Next, click on the “Add Redirect” button and click Save.

Understanding the redirect types, rules, and formats:

Redirect Types

  1. Static Redirect: A simple URL-to-URL redirect without any dynamic values.
  1. Dynamic Redirects: A complex URL where you can use dynamic values instead of adding 10s or 100s of static redirects.

Supported redirect formats

Feature
Old Path
New Path
Notes
Redirects
/home
/
302 is used as the default status code.
Splats
/blog/*
/blog/en/:splat
Refer to Splats.
Placeholders
/blog/:year/:month/:date/:slug
/news/:year/:month/:date/:slug
See Placeholders
Force
/pagethatexists
/otherpage
Redirects are always followed, regardless of whether or not an asset matches the incoming request.

Rules:

  1. If there are multiple redirects for the same source path, the top-most redirect is applied.
  1. Redirects happen before headers, so if a request matches rules in both files, the redirect will win out
  1. Static redirects need to be added first, and then the dynamic redirects.
  1. A project can have a maximum of 2,000 static redirects and 100 dynamic redirects for a total of 2,100 redirects.
  1. Each redirect declaration has a 1,000-character limit.

Splats

On matching, a splat (asterisk, *) will greedily match all characters. You may only include a single splat in the URL.
The matched value can be used in the redirect location with:splat.

Placeholder

A placeholder can be defined with:placeholder_name
  • The colon indicates the start of a placeholder, and the name that follows may be composed of alphanumeric characters and underscores, :\w+.
  • A placeholder with a given name can only be used once in the URL. Placeholders match all characters apart from the delimiter, which: when part of the host, is a period or a forward-slash; and when part of the path, is a forward-slash.
  • The matched value can similarly be used in the redirect location with :placeholder_name. By doing this, it allows for greater flexibility and usability for both users and developers.

Unsupported Redirects

The following redirects are not supported. Make sure not to use any of these.
Feature
Old Path
New Path
Query Parameters
/shop?id=:id
/blog/:id
Rewrites (other status codes)
/blog/*
/blog/404.html
Proxying
/blog/*
Domain-level redirects
If you have any questions, contact us directly in the live chat. We will guide you through.