Why Your Redirection Plugin Isn't Working: Common Issues and Solutions
Content
Understanding and Fixing Common Redirection Plugin Problems
The 'Redirection' plugin for WordPress is a powerful tool, but like any complex software, it can sometimes behave in unexpected ways. Based on community reports and troubleshooting discussions, here are the most common issues users face and how to resolve them.
1. The Dreaded Redirect Loop
Problem: You set up a redirect, but it creates an infinite loop, resulting in an "ERR_TOO_MANY_REDIRECTS" error.
Why it happens: This typically occurs when multiple redirects conflict with each other. WordPress's own redirect_canonical() function might be automatically redirecting a URL, and then the 'Redirection' plugin tries to redirect it again to a different destination. Other plugins or server configurations might also be creating conflicting redirects.
Solution:
- Identify the loop: Use an online tool like Redirect Li to trace each hop of the redirect chain and see where the conflict originates.
- Check for conflicts: Temporarily disable other redirect-related plugins or review your server's
.htaccessfile for rules that might be interfering. - Adjust match type: In the 'Redirection' plugin settings, try changing the match type for your rule to "URL only" instead of the default "URL and server."
2. Cache Conflicts
Problem: You create a redirect, but it doesn't work until you clear your site's cache.
Why it happens: Caching plugins (e.g., WP Fastest Cache) or server-level caching serve old, stored versions of pages. If a page was cached before you created the redirect, the cached version will be served without triggering the new redirect rule.
Solution:
- Clear all caches: After creating or modifying a redirect, clear your WordPress cache, browser cache, and any server-side cache.
- Reconfigure caching: Some users have reported success by excluding certain file types or the 'Redirection' plugin's logic from their caching rules, particularly on Nginx setups.
3. The Mismatched URL (Trailing Slash and Case Sensitivity)
Problem: A redirect for /page doesn't work, but a redirect for /page/ does.
Why it happens: The plugin's matching is exact by default. A source URL of /add will not match a request for /add/ unless the "Ignore trailing slashes" setting is enabled.
Solution:
- Be precise when entering your source URL. If your old page was
/old-page/, include the trailing slash. - Enable the "Ignore trailing slashes" option in the plugin's settings under Settings > Redirection > Groups to make matching more flexible.
- Pay attention to the "Ignore Case" option when creating your rule if capitalization might be an issue.
4. Import and API Issues
Problem: Redirects imported via CSV don't work, but manually creating the exact same rule does. Or, using the API creates a redirect without a target.
Why it happens: CSV formatting can be tricky. A hidden space, incorrect column order, or improper encoding can cause the import to fail silently. For the API, the issue is often an incorrectly formatted JSON payload.
Solution:
- Check your CSV: Ensure your file has only two columns (source and target) with no headers. Avoid blank rows. Open the file in a plain text editor to check for hidden formatting characters.
- Check the API payload: The most common API error is malformed JSON. Ensure your request correctly sends the
action_dataparameter with the target URL. The example payload in the threads shows a successful format.
5. The .htaccess File Isn't Updating
Problem: You've added redirects to an Apache group, but they are not written to the .htaccess file.
Why it happens: This is almost always a file permissions issue. The WordPress application does not have write access to the .htaccess file.
Solution:
- Connect to your server via FTP/SFTP and check the permissions on the
.htaccessfile. It typically needs to be 644 or 664. - Confirm the file path the plugin is using is correct. The path is usually found in the plugin's Support tab.
- If the file can't be written to, you may need to manually add the redirect rules to your
.htaccessfile or contact your hosting provider to adjust the permissions.
General Troubleshooting Steps
If you encounter an issue, always start with this checklist:
- Clear all cache: WordPress, browser, and server cache.
- Check for conflicts: Temporarily disable other plugins to see if the issue resolves.
- Review the redirect log: The 'Redirection' plugin has a logging feature. Enable it to see exactly what URL was requested and which redirect, if any, was matched.
- Double-check your settings: A small typo or a mismatch in trailing slashes is the most common cause of a failed redirect.
By methodically working through these common problems, you can usually identify and fix why your 'Redirection' plugin isn't working as expected.
Related Support Threads Support
-
Redirect from TranslatePress translated pages,a slash is added to the target urlhttps://wordpress.org/support/topic/redirect-from-translatepress-translated-pagesa-slash-is-added-to-the-target-url/
-
Incorrect redirection occuringhttps://wordpress.org/support/topic/incorrect-redirection-occuring/
-
Issues with user rolehttps://wordpress.org/support/topic/issues-with-user-role/
-
Redirection not workinghttps://wordpress.org/support/topic/redirection-not-working-58/
-
URL Monitoring auto-create two redirect recordshttps://wordpress.org/support/topic/url-monitoring-auto-create-two-redirect-records/
-
Same URL but multiple redirectshttps://wordpress.org/support/topic/same-url-but-multiple-redirects/
-
Redirecting to original url after editing target urlhttps://wordpress.org/support/topic/redirecting-to-original-url-after-editing-target-url/
-
False catch of 301https://wordpress.org/support/topic/false-catch-of-301/
-
Redirect plugin stopped redirectinghttps://wordpress.org/support/topic/redirect-plugin-stopped-redirecting/
-
Redirect loop due to redirect_canonical() functionhttps://wordpress.org/support/topic/redirect-loop-due-to-redirect_canonical-function/
-
Minor Bug – Last access date breaks after editing Redirecthttps://wordpress.org/support/topic/minor-bug-last-access-date-breaks-after-editing-redirect/
-
red cross sign appear after click “check redirect”https://wordpress.org/support/topic/red-cross-sign-appear-after-click-check-redirect/
-
Redirects not enabled upon creationhttps://wordpress.org/support/topic/redirects-not-enabled-upon-creation/
-
Created Redirect with API, but doesn’t add Target URL, only source URL.https://wordpress.org/support/topic/created-redirect-with-api-but-doesnt-add-target-url-only-source-url/
-
disable redirection stopped workinghttps://wordpress.org/support/topic/disable-redirection-stopped-working/
-
Redirects get ignored until i clear cache?!https://wordpress.org/support/topic/redirects-get-ignored-until-i-clear-cache/
-
Image redirection not workinghttps://wordpress.org/support/topic/image-redirection-not-working/
-
Issue with redirection pluginhttps://wordpress.org/support/topic/issue-with-redirection-plugin/
-
[NSFW] Forwarding to slug/… does not workhttps://wordpress.org/support/topic/forwarding-to-slug-does-not-work/
-
Redirects back to sourcehttps://wordpress.org/support/topic/redirects-back-to-source/
-
Question on how to use redirection_url_sourcehttps://wordpress.org/support/topic/question-on-how-to-use-redirection_url_source/
-
Redirect to Amazon stopped workinghttps://wordpress.org/support/topic/redirect-to-amazon-stopped-working/
-
Error installinghttps://wordpress.org/support/topic/error-installing-19/
-
redirects not present in the apache filehttps://wordpress.org/support/topic/redirects-not-present-in-the-apache-file/
-
Redirection when running WordPress in its own folderhttps://wordpress.org/support/topic/redirection-when-running-wordpress-in-its-own-folder/
-
Unexpected Redirect and Redirect Chainhttps://wordpress.org/support/topic/unexpected-redirect-and-redirect-chain/
-
sometimes works and sometimes does not work…why?https://wordpress.org/support/topic/sometimes-works-and-sometimes-does-not-work-why/
-
Automatic Redirection Bughttps://wordpress.org/support/topic/automatic-redirection-bug/
-
Conflicts with “Redirect to this URL after subscription” of Brevo pluginhttps://wordpress.org/support/topic/conflicts-with-redirect-to-this-url-after-subscription-of-brevo-plugin/
-
Cannot find auto redirect optionhttps://wordpress.org/support/topic/cannot-find-auto-redirect-option/
-
PHP API Red_Item parameters update – something changedhttps://wordpress.org/support/topic/php-api-red_item-parameters-update-something-changed/
-
Warning when redirecting .htmlhttps://wordpress.org/support/topic/warning-when-redirecting-html/
-
URLs with “news” in it are not redirectedhttps://wordpress.org/support/topic/urls-with-news-in-it-are-not-redirected/
-
redirection_create_redirect not availablehttps://wordpress.org/support/topic/redirection_create_redirect-not-available/
-
Entry Coupling Causes All Entries to be Deletedhttps://wordpress.org/support/topic/entry-coupling-causes-all-entries-to-be-deleted/
-
Issue with redirecthttps://wordpress.org/support/topic/issue-with-redirect-3/
-
URLs with query parameters don’t get redirected.https://wordpress.org/support/topic/urls-with-query-parameters-dont-get-redirected/
-
Redirect only working by adding manuallyhttps://wordpress.org/support/topic/redirect-only-working-by-adding-manually/
-
Not Workinghttps://wordpress.org/support/topic/not-working-3901/
-
Not saving anymore URLshttps://wordpress.org/support/topic/not-saving-anymore-urls/
-
Redirect only works on F5https://wordpress.org/support/topic/redirect-only-works-on-f5/
-
Redirection to external URLs failinghttps://wordpress.org/support/topic/redirection-to-external-urls-failing/
-
Exclude Redirection Plugin From Nginx Cachinghttps://wordpress.org/support/topic/exclude-redirection-plugin-from-nginx-caching/
-
Redirect only works when I enter a trailing slashhttps://wordpress.org/support/topic/redirect-only-works-when-i-enter-a-trailing-slash/