How to use to handle redirects on a subpath

Learn how to configure on a subpath of an existing domain.

Steven Tey

Written by Steven Tey

With, you can easily set up redirects on a subpath of an existing domain.

This is useful if you are already using the domain for your website/app and only want to use for a specific subpath.

For example, if you have a website at and want to add link-sharing features under (e.g., you can use to handle the redirects for this subpath without affecting the rest of your website.

Step 1: Add a subdomain to

First, you need to add a subdomain of your existing domain to

For example, if your domain is, you can add a subdomain like

You can follow these steps to add a subdomain to

Step 2: Configure rewrites/redirects

Once you've added the subdomain, you can use rewrites or redirects to mask the subdomain and handle the redirects on the subpath.

URL Rewrites example
URL Rewrites example

There are a few ways to configure this, depending on your application framework/hosting provider.

Using Next.js

If you are using Next.js, you can use the rewrites property in your next.config.js file to configure subpath redirects.

module.exports = {
  async rewrites() {
    return [
        source: "/r/:path*",
        destination: "*",

Using Nuxt

If you are using Nuxt, you can use Nuxt's server route feature to configure subpath redirects.

First, create a new catch-all route in the respective subpath: server/routes/r/[...slug].ts

Then, in the route, add the following code:

// ~/server/routes/r/[...slug].ts

export default defineEventHandler(async (event) => {
  const dubPath = getRouterParam(event, "slug");
  await sendRedirect(event, `${dubPath}`, 301); // use whatever status code you need

Using Vercel

If you're using Vercel, you can use the rewrites property in your vercel.json file to configure subpath redirects.

  "rewrites": [
      "source": "/r/:path*",
      "destination": "*"

Using Netlify

If you're using Netlify, you can use the redirects property in your _redirects file to configure subpath redirects.

/r/* 200

Using Cloudflare

If you're using Cloudflare, you can use the Redirect Rules feature to configure subpath redirects.

  1. Go to your Cloudflare dashboard for your website and click on Rules > Redirect Rules.
  2. Click on Create Rule.
  3. Give your rule a name, e.g. "Redirect subpath".
  4. Under When incoming requests match:
    • Select Custom filter expression
    • Field: URI Path
    • Operator: starts with
    • Value: /r/
  5. Under Then:
    • Type: Dynamic
    • Expression: concat("", substring(http.request.uri.path, 3))
    • Status code: 301
    • Preserve query string: ✔️
  6. Click on Deploy.

The number in the substring function in the Expression field should be equal to the number of characters in the subpath. In our case, the subpath is /r/ which has 3 characters, so we use substring(http.request.uri.path, 3).

Here's an example of how the rule should look like:

Cloudflare Redirect Rules example
Cloudflare Redirect Rules example

Using Webflow

If you're using Webflow, you can use the Wildcard redirects feature to configure subpath redirects.

  1. Go to Site settings > Publishing tab > 301 redirects
  2. Add a new redirect with the following settings:
    • Old path: /r/(.*)
    • Redirect to page:
  3. Click on Save.

Using Squarespace

If you're using Squarespace, you can use the URL Mappings feature to configure subpath redirects.

  1. Open the Developer tools panel.
  2. Click URL mappings.
  3. Click into the text field and add the following redirect:
/r/[slug] ->[name] 301
  1. Click Save.

Did this answer your question?