How to Set Up URL Redirects and Rewrites in Firebase Hosting

1{
2  "hosting": {
3    "public": "dist",
4    "redirects": [
5      {
6        "source": "/old-page",
7        "destination": "/new-page",
8        "type": 301
9      },
10      {
11        "source": "/blog/2023/intro",
12        "destination": "/blog/getting-started",
13        "type": 301
14      }
15    ]
16  }
17}

1{
2  "hosting": {
3    "public": "dist",
4    "redirects": [
5      {
6        "source": "/blog/:year/:slug",
7        "destination": "/articles/:slug",
8        "type": 301
9      },
10      {
11        "source": "/docs/v1/**",
12        "destination": "/docs/v2/:0",
13        "type": 301
14      },
15      {
16        "source": "/category/:name/posts/:postId",
17        "destination": "/posts/:postId",
18        "type": 301
19      }
20    ]
21  }
22}

1{
2  "hosting": {
3    "public": "dist",
4    "redirects": [
5      {
6        "source": "/support",
7        "destination": "https://help.example.com",
8        "type": 302
9      },
10      {
11        "source": "/github",
12        "destination": "https://github.com/your-org/your-repo",
13        "type": 301
14      },
15      {
16        "source": "/api/legacy/**",
17        "destination": "https://old-api.example.com/:0",
18        "type": 301
19      }
20    ]
21  }
22}

1{
2  "hosting": {
3    "public": "dist",
4    "rewrites": [
5      {
6        "source": "/api/**",
7        "function": {
8          "functionId": "api",
9          "region": "us-central1"
10        }
11      },
12      {
13        "source": "/webhook",
14        "function": "webhookHandler"
15      },
16      {
17        "source": "**",
18        "destination": "/index.html"
19      }
20    ]
21  }
22}

1// Evaluation order:
2// 1. Reserved Firebase URLs (/__/auth, /__/firebase)
3// 2. Exact file match in public directory
4// 3. Redirects (first match wins, top to bottom)
5// 4. cleanUrls / trailingSlash processing
6// 5. Rewrites (first match wins, top to bottom)
7// 6. Custom 404 page
8
9// Example: If /about.html exists as a static file:
10// - A redirect from /about will NOT apply (static file matched first)
11// - A rewrite from /about will NOT apply (static file matched first)
12// - To force a redirect, rename or delete the static file

1# Deploy hosting configuration
2firebase deploy --only hosting
3
4# Test a redirect (check status code and Location header)
5curl -I https://your-project.web.app/old-page
6# Expected output:
7# HTTP/2 301
8# location: /new-page
9
10# Test a rewrite (should return Cloud Function response)
11curl https://your-project.web.app/api/health
12# Expected output: response from your Cloud Function
13
14# Test with preview channel first
15firebase hosting:channel:deploy test-redirects --expires 1d