Provides a degree of backwards compatibility when switching between permalink structures.
Backwards Compatible Permalinks helps prevent 404 errors when switching between permalink structures.
It achieves this by appending a set of backwards compatible post rewrite rules. This ensures posts are still accessible at their previous permalink after the permalink structure is updated.
Let’s say your permalink structure is set to “Month and name” and you have a post titled “I Love WordPress.” That particular post would live at
But what if you wanted to switch to the “Post name” permalink structure and have your post live at
You could but this would result in the existing post permalink 404ing when visited. Which is problematic if the previous URL was bookmarked or shared on social media.
With Backwards Compatible Permalinks installed your post would be accessible at both the old and new permalink structures:
After deactivating or uninstalling this plugin please ensure you visit Settings > Permalinks in the WordPress admin area to flush your rewrite rules.
Contributions are welcomed on GitHub.
backwards-compatible-permalinksfolder to the
This is currently not supported, the post will be accessible at both URLs. I agree that this isn’t the ideal behaviour but it was too tricky to support redirects while also ensuring query parameters and “/page/xx” and “/comment-page-xx” modifiers were respected during the redirect. The good news is that the canonical tag will always point to the new URL so there shouldn’t be any SEO ramifications.
A single filter is available. You may use the
aprea_back_compat_permalink_structure filter to provide a backwards compatible permalink structure, e.g.
This is helpful if you updated the permalink structure prior to installing this plugin.
I’m terribly sorry! You may want to check the caveats section to see if any apply to your situation. Otherwise feel free to post in the support forums.