Skip to content
WP PowerSuiteWP PowerSuite Docs

Quick navigation

Popular modules

Browse by category

Security19/19Login & UserssoonAdminsoonContentsoonMediasoonSEO & VisibilitysoonSpeedsoonSite Toolssoon
↑↓ navigate↵ openesc close154 guides · 155 modules
Select theme
Get Started

Redirect Manager

Summarize with AI

Redirect Manager points old URLs to new ones after redesigns or migrations - exact matches, wildcards, regex, optional error responses, and CSV tools.

What it does

Section titled “What it does”
  • Dedicated Redirect Manager page: list, Add Redirect, search, bulk actions, hit counts.
  • Basic settings: Source URL, Target URL (or page picker), Match Type (Exact, Wildcard (*), Regex), When Matched (Redirect / Show Error).
  • Redirect Type: 301 Permanent, 302 Found, 303 See Other, 307 Temporary, 308 Permanent.
  • Error Type / Error Message for codes such as 401-405, 410, 501-503.
  • Priority (lower runs first), Strip query parameters when redirecting, Notes.
  • Optional Conditions: Login Status, Referrer, Browser Language, URL Parameter.
  • Export CSV, Import (sample CSV available), Test URL, duplicate, toggle active, loop detection.
  • Rules run on wp_loaded (before typical 404 handlers). Requires license.

When to use it

Section titled “When to use it”

Enable it if:

  • You migrated permalinks or domains and need lasting 301s.
  • One rule should cover many paths (/blog/* -> /news/$1).
  • You need conditional redirects (logged-in only, referrer, query param).

When not to use it

Section titled “When not to use it”

How to enable it

Section titled “How to enable it”
  1. Activate your WP PowerSuite license.
  2. Enable Redirect Manager under WP PowerSuite -> Modules.
  3. Open WP PowerSuite -> Redirect Manager.
  4. Click Add Redirect, fill Source URL / Target URL, choose match and type, then Create Redirect.
  5. Use Test URL to confirm the match before relying on it in production.

How to test it

Section titled “How to test it”
  • Add Exact /old-page/ -> /new-page/ as 301; visit /old-page/.
  • ✅ Pass: browser lands on /new-page/ with a permanent redirect.
  • Add Wildcard /blog/* -> /news/$1; visit /blog/hello.
  • ✅ Pass: redirects to /news/hello.
  • Use Test URL with a path that should match.
  • ✅ Pass: result names the matching rule.
  • ❌ Fail: check Priority, active status, and that another plugin is not redirecting first.

Troubleshooting

Section titled “Troubleshooting”
  • Redirect loop error on save. Change the target so it does not chain back to the source.
  • Import failed. File must be CSV under 1 MB with at most 1,000 rows; duplicates/invalid rows are skipped.
  • Rule not firing. Confirm the rule is active, Match Type matches the path format, and cache/CDN is not serving a stale response.

Manage with WP-CLI

Section titled “Manage with WP-CLI”

Prefer the command line? You can turn this module on or off with WP-CLI instead of the dashboard:

Terminal window
# Turn the module on
wp powersuite module enable redirect-manager


# Turn the module off
wp powersuite module disable redirect-manager


# Check whether it is on, its category, and where its settings live
wp powersuite module get redirect-manager

Managing more than one site? Add --url=https://example.com to point a command at one site. If this is a Pro module, install WP PowerSuite Pro and activate your license first. New to WP-CLI? See the full command guide.

Extra commands for this module

Section titled “Extra commands for this module”

List, export, and import your redirects from the command line:

Terminal window
# See every redirect
wp powersuite redirects list


# Save all redirects to a CSV file
wp powersuite redirects export redirects.csv


# Load redirects from a CSV file (preview first, then apply)
wp powersuite redirects import redirects.csv --dry-run
wp powersuite redirects import redirects.csv

The CSV uses these columns: source,target,type,match_type,notes. Rows that are invalid or duplicated are skipped, and --dry-run lets you preview an import before it is saved.

FAQ

Section titled “FAQ”
What does Redirect Manager do?

It stores redirect rules and runs them early on the front end with Exact, Wildcard (*), or Regex match types, plus optional Show Error responses.

Is Redirect Manager free?

No. It ships in the WP PowerSuite Pro add-on. Install Pro beside the free plugin and activate your license.

Which redirect types are supported?

Redirect Type includes 301 Permanent, 302 Found, 303 See Other, 307 Temporary, and 308 Permanent. Show Error covers codes such as 404 and 410.

Can I import redirects?

Yes. Import a CSV with source, target, type, and match_type columns (max 1 MB / 1,000 rows), or Export CSV from the list.

How do I turn Redirect Manager off?

Go to WP PowerSuite -> Modules, find Redirect Manager, and toggle it off.

Developer notes (hooks & filters)

Source: modules/redirect-manager/module.php. Boot: critical · context: admin, frontend, ajax.

Table: {prefix}wpps_redirects. Executes on wp_loaded priority 1. Admin-post/AJAX handlers for save, delete, bulk, import, export, toggle, test URL.

Section titled “Related modules”