X-Redirect-By header: a standard proposal
Redirects, and in particular redirect loops, can be incredibly hard to troubleshoot. We have a solution for that, called an X-Redirect-By header. It’s a simple addition that allows us to find which piece of code is responsible for doing a particular redirect. Yoast SEO already does this and we think every other system in the world should mimic the behavior.
If you’ve ever had to diagnose larger systems, you’ll know that knowing where the redirect comes from can save you a lot of time. This is a common problem for both SEOs and web developers diagnosing weird redirect loops.
Simple standard proposal
The proposal is simple: every system that sends a redirect and/or has a method in place for sending redirects should prefix that redirect. Right before the location header, there should be an X-Redirect-By
header with an identifier as its value. This identifier should clearly identify which piece of software performed the redirect.
Example of an X-Redirect-By header
When you open up https://yoast.com/wordpress-hosting-old/
you’re redirected, by our plugin, to another page. The actual headers look like this:
HTTP/1.1 301 Moved Permanently X-Redirect-By: Yoast SEO Premium Location: https://yoast.com/westhost-wordpress-hosting/
This clearly identifies Yoast SEO as the one responsible for executing that redirect. Now, if I want to change that redirect, I now know where to go and fix it.
Real world use case
Recently, we had an issue here at Yoast with a bit of code we have for redirecting UTM tags. The piece of code had its own X-Redirect-By header, and within 2 minutes, we’d found the culprit. The bug was obscure, so without that X-Redirect-By header, we would have been searching for quite a while. Searching just to figure out where in our application this redirect was being generated.
As I was discussing this header with Mark Jaquith, one of the WordPress lead developers, for inclusion in WordPress, he said:
That’s the point.
Comments? Suggestions? Implementations?
I’d love to hear your comments and suggestions and I’d love even more to see you link to implementations in systems all over the world. It’s simple standards like these that can make our life just that tiny bit easier.
Coming up next!
-
Event
WordCamp Netherlands 2024
November 29 - 30, 2024 Team Yoast is at Sponsoring WordCamp Netherlands 2024! Click through to see who will be there, what we will do, and more! See where you can find us next » -
SEO webinar
The SEO update by Yoast - October & November 2024 Edition
26 November 2024 Get expert analysis on the latest SEO news developments with Carolyn Shelby and Alex Moss. Join our upcoming update! 📺️ All Yoast SEO webinars »
i am not a premium user of yoast seo plugin, is your free version support X-Redirect-By header?
Great!! Yoast is a very good plugin i had no Problem with it till now.