Redirects

Stardust supports redirects for when you move, rename, or restructure pages. Redirects ensure old URLs continue to work, preserving SEO and preventing broken links.

Frontmatter Redirects

The simplest way to redirect old URLs to a page is using redirect_from in frontmatter:

---
title: Getting Started
redirect_from:
  - /quick-start
  - /docs/introduction
---

This creates redirects from /quick-start and /docs/introduction to the current page.

Config-Based Redirects

For more control, define redirects in stardust.yaml:

build:
  redirects:
    - from: /old-page
      to: /new-page
    - from: /blog/2023/post
      to: /articles/post
      status: 302

Options

Wildcards and Patterns

Config-based redirects support wildcards for bulk redirects:

build:
  redirects:
    # Redirect entire directory
    - from: /docs/*
      to: /guide/:splat

    # Named parameters
    - from: /posts/:slug
      to: /blog/:slug

Examples

Renaming a Page

When you rename quick-start.md to getting-started.md:

---
title: Getting Started
redirect_from:
  - /quick-start
---

Restructuring Docs

When moving pages to a new structure:

build:
  redirects:
    - from: /api/auth
      to: /reference/authentication
    - from: /api/users
      to: /reference/users

Bulk Redirects

When moving an entire section:

build:
  redirects:
    - from: /v1/*
      to: /v2/:splat

Status Codes

Limitations

• Cannot redirect from / (root path)
• Pattern redirects require a supported hosting platform