redirects.yaml

A reviewable file for hosts, destinations, path rules and pages.

A complete example

version: 1
rules:
  - hosts: [oldproduct.com, oldproduct.net]
    to: https://newproduct.dev
    paths:
      - from: /blog/*
        to: https://newproduct.dev/journal/*

  - hosts: [spring-launch.com]
    to: https://newproduct.dev/launch
    status: 302

  - hosts: [greatname.dev]
    action: page
    page: { template: forSale, price: "4500", currency: USD }

Redirects and paths

Version 1 supports 301, 302, 307 and 308. Redirect destinations use HTTPS. Paths are kept by default; ordered path rules can route an individual path or a trailing wildcard elsewhere. Preserve query strings to keep existing links useful.

Pages

Choose parked, forSale or charity. A price is an exact decimal string in major units with an explicit ISO currency code. Use "4500" with USD, "4500" with JPY, or "4500.125" with BHD. Amounts are never converted between currencies. For-sale inquiries are a Pro feature; a page fixture does not enable live submissions.

Validation

Unknown versions, fields, duplicate explicit hosts and incompatible action branches fail validation. Reserved /_fwd routes belong to Forward. Review the sync plan before applying the file.