Set up redirections

Configure URL redirects to handle moved or renamed pages.

Redirects are managed in the Redirects tab of site settings.

Set up Redirections in Capable Sites

#Format

Redirect rules are entered as plain text, one rule per line:

literal /old-path /new-path permanent
literal /old-page /new-page temporary

Component

Description

literal

Match type (literal path match)

/old-path

The source path to redirect from

/new-path

The destination path to redirect to

permanent

301 redirect (permanent — search engines transfer ranking)

temporary

302 redirect (temporary — search engines keep the original URL)

#Comments

Lines starting with # are treated as comments:

# Redirect old documentation URLs
literal /v1/getting-started /docs/getting-started permanent

# Temporary redirect during migration
literal /beta /new-beta temporary

#Constraints

  • Maximum 50,000 characters for all redirect rules combined

  • Each rule must be on its own line