Skip to content

URL Redirects

SWS provides the ability to redirect request URLs with pattern matching support.

URI redirects are particularly useful with pattern matching (globs). Use them for example to prevent broken links if you've moved a page or to shorten URLs.

Structure

The URL redirect rules should be defined mainly as an Array of Tables.

Each table entry should have the following key/value pairs:

  • One source key containing a string glob pattern.
  • One destination string containing the local file path or a full URL.
  • One kind number containing the HTTP response code.

Note

The incoming request(s) will reach the destination only if the request(s) URI matches the source pattern.

Source

The source is a Glob pattern that should match against the URI that is requesting a resource file.

Destination

A local file path must exist. It can be a local path /some/directory/file.html or a full URL. It is worth noting that the / at the beginning indicates the server's root directory.

Kind

It indicates the HTTP response code. The values can be:

  • 301 for "Moved Permanently"
  • 302 for "Found" (Temporary Redirect)

Examples

[advanced]

### URL Redirects

[[advanced.redirects]]
source = "**/*.{jpg,jpeg}"
destination = "/images/generic1.png"
kind = 301

[[advanced.redirects]]
source = "/index.html"
destination = "https://static-web-server.net"
kind = 302

Last update: 2023-03-27