AgenCMS

Redirects

Redirects send visitors from an old URL to a new one. Use them when you rename a page, retire content, or move to a new structure, so old links and search results keep working.

Open the redirects list

  1. Go to your dashboard at /dashboard.
  2. Open the website you want to manage.
  3. Open Redirects for that site at /dashboard/websites/{website}/redirects.

The list shows each rule's source path, match type, destination, HTTP status, total hits, and the last time it was triggered. Inactive rules appear dimmed. Rules created automatically by the builder (for example, when you change a page slug) are tagged System.

Create a redirect

  1. On the redirects list, click New redirect.
  2. Fill in the Source and Destination sections.
  3. Click Save redirect.

Source

  • Source path is the incoming path to match, like /old-page. This field is required.
  • Match type controls how the path is compared. See Match types below.
  • Source domain is optional. Leave it empty to match all domains, or enter a domain to restrict the rule to one host.

Destination

  • HTTP status picks the redirect code. See Choosing a status code.
  • Destination type is either Internal path (a path on this website) or External URL (a full address starting with https://).
  • For an internal destination, use Choose internal destination to pick a real page, post, archive, category, or tag. You can also type a path directly in Destination path. Typing a path switches the rule back to a manual path and overrides the picker selection.
  • For an external destination, enter the full URL in Destination URL, including https://.

Match types

The match type decides which incoming URLs a rule catches.

  • Exact matches the path exactly as entered. /old-page matches only /old-page.
  • Prefix matches any URL that starts with the path. /blog matches /blog, /blog/news, and anything beneath it.
  • Wildcard matches using a * pattern. The source path must include a * segment, otherwise the rule is rejected. For example, /docs/* catches everything under /docs/.

When more than one rule could match, exact rules win first, then prefix, then wildcard. Within the same match type, the higher Priority value is evaluated first.

Choosing a status code

  • 301 Permanent transfers search ranking to the new URL. Use this for permanent moves.
  • 302 Temporary keeps the original URL indexed. Use this for short-lived redirects.
  • 307 Temporary (preserve method) keeps the HTTP method, so a POST stays a POST.
  • 308 Permanent (preserve method) is a permanent redirect that also preserves the method.

Options

  • Priority sets the evaluation order, from 1 to 1000. Higher values are checked first. The default is 100.
  • Note is an optional reminder of why the redirect exists.
  • Preserve query params forwards ?key=value strings to the destination. This is on by default.
  • Rule active turns the rule on or off. Turn it off to disable a redirect without deleting it.

Manage existing redirects

From the redirects list you can:

  • Edit a rule by clicking its source path, which opens /dashboard/websites/{website}/redirects/{redirect}/edit. Change any field and save.
  • Enable or disable a rule with the toggle in the Active column.
  • Delete a rule with its row action. Deleting cannot be undone.

The Hits and Last hit columns help you see which redirects are actually being used, so you can clean up rules that no longer fire.

Things to watch for

  • A source path cannot redirect to the same path with an exact match. Pick a different destination.
  • External destinations must be valid absolute URLs.
  • You cannot create two rules with the same source path, domain, and match type. Edit the existing rule instead.