Managing Page Redirects

Adding redirects for your website links.

notion image
  1. Click on “Settings” of your website in Bullet dashboard and navigate to the “Redirects” section.
  1. Scroll down to the re-directs 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 dymamic values.
  1. Dymanic 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, 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 to not 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/*
https://blog.my.domain/:splat
Domain-level redirects
http://workers.example.com/*
http://workers.example.com/blog/:splat 301
If you have any questions, contact us directly in the live chat. We will guide you through.