HREFbuilder: Making HREFlang sitemaps a little bit easier
Search Engine Optimisation

HREFbuilder: Making HREFlang sitemaps a little bit easier

12th September 2016

Since the introduction of HREFlang meta tags in 2010 to help Google understand geo-targeted content on websites, webmasters and SEOs have struggled with implementing it correctly. In theory applying HREFlang tags is pretty straightforward: just show Google what alternative versions you have of a given page, and which language & country those versions are targeting.

In practice, HREFlang tag implementations are cumbersome, confusing, and often lead to Search Console reports like this:

Google Search Console HREFLANG errors report

Apparently, HREFlang tags aren’t easy to get right. The struggles with HREFlang over the years haven’t been helped by bugs in Search Console causing the ‘International Targeting’ report to show errors with HREFlang implementations that were actually entirely correct. The Google product forums are full of posts by webmasters who have implemented HREFlang tags, but Search Console throws up all kinds of errors.

Now we finally have a tool to help us implement HREFlang in what is probably the easiest and most straightforward way: through HREFlang XML sitemaps. Rather than tag individual pages with HREFlang meta tags, you can upload specialised XML sitemaps that tells Google all it needs to know about your website’s geo-targeted content.

The folks at Back Azimuth first created this HREFbuilder tool for internal usage, and have now made it available for the general public. They’ve graciously provided us with a free account for the purpose of this review.

Using HREFbuilder for your HREFlang XML sitemap

When you log in to the HREFbuilder tool, first you need to create a new project. The tool is built to be as flexible as possible to allow for almost any imaginable scenario regarding your geo-targeted content, so you have multiple options for generating your international XML sitemaps.

Hrefbuilder - creating a new project

As you can see, the tool allows for many different data sources, so whatever your particular context you will probably have the data already handy.

I really like the option to upload a Screaming Frog crawl export, because that allows you to create sitemaps for sites that aren’t live yet – you can crawl a development website and submit those URLs to the tool to generate an international sitemap that’s ready to go live together with the site.

Next you need to let the tool know how your website is implementing its geo-targeted content:

Hrefbuilder - select your country and language structure

This is a very long list of options, so it’s exceptionally unlikely that your particular scenario is not listed here. Even then, you have the option to create a custom configuration in case your specific approach isn’t listed.

Double-check and make sure you select the correct option! Picking the wrong structure will cause the tool to throw up errors rather than correct HREFlang sitemaps.

Once you’ve picked the right format for your international content, you need to supply the tool with the data so it can generate the appropriate HREFlang sitemaps.

In my test project, I had two data sources for three sets of tags: a standard XML sitemap from a .com site that was targeted at en-GB, an XML sitemap from a .ie website aimed at en-IE, and the .com sitemap again to use as the x-default version.

Hrefbuilder - submit data files

There’s a variety of additional options in the HREFbuilder tool, allowing for all kinds of different scenarios. For example, you can opt not to crawl the URLs you submit, which is handy if your site isn’t live yet.

Once you submit the data sources and have all the options set as you want them, you can create the project. At this stage the tool will start to crawl the URLs that you’ve submitted – unless you chose to forfeit that feature – and then generate your XML sitemaps for you. HREFbuilder provides you with a dashboard to let you know how it’s getting on with the crawl:

Hrefbuilder - project dashboard

When the tool has checked all your URLs, you can generate your XML sitemaps and subsequently download them to your PC. After that it’s simply a matter of uploading the files to your website and submitting them to Search Console.

Since websites change all the time, with content being added, changed, and removed, the tool also offers a Cron Job feature that allows you to re-create your XML sitemaps regularly.

Hrefbuilder - Cron Jobs

Now I have to admit that using the tool for this review was not all plain sailing. It’s not the easiest tool to use. The HREFbuilder tool has a lot of different options, allowing for literally hundreds of different ways to generate HREFlang sitemaps. And it’s easy to get lost in those options, uncertain of what you need to fill in and what you can safely skip.

Now while I’m no rocket scientist, I do have some measure of confidence in my capabilities as an SEO. Yet when I first used it, this tool made me feel like an idiot. It took me several attempts and, in fact, some hands-on help from the lovely Bill Hunt from Back Azimuth, to wrap my head around exactly what the tool needed from me to generate the correct XML sitemaps.

After I finally ‘got it’ though, it became a very smooth process, and I came to appreciate the wealth of options and configurations HREFbuilder offers. It’s not for beginners nor the faint of heart, and hardcore SEOs are going to love this tool’s awesome set of features.

Additional Tools

The HREFbuilder tool is not the only tool the folks at Back Azimuth have on offer. There’s another tool called Index Checker which, as the name suggests, checks if a page is in Google’s index. You can supply a list of URLs for the tool to monitor, and it’ll report back on which URLs are indexed and which aren’t.

Then there’s the HTTP Redirect Checker, which checks for correct redirects as well as redirect chains. What I like about all these tools is that you don’t need to sign up to an expensive monthly subscription – you can pay for them as one-off projects.

Lastly, I need to mention their free HREFlang Validator, where you can submit a URL or HREFlang XML sitemap and see if everything is correctly implemented.

HREFlang validator tool

I have to commend the folks at Back Azimuth for creating these tools and making them available for public use. International targeting through HREFlang tags is complicated and confusing, and any tool designed to handle this is by extension also complicated and potentially confusing. Some ‘how-to’ explainer videos would definitely help, and perhaps a more elaborate set of tooltips and explanations within the tool.

But once it ‘clicks’ and you get it, this tool will save you immeasurable amounts of time and effort, not to mention prevent a shipload of arguments with web developers – because you won’t have to explain HREFlang to them anymore to have it implemented correctly. You can simply do it yourself.


Written By
Barry Adams is the chief editor of State of Digital and is an award-winning SEO consultant delivering specialised SEO services to clients worldwide.
  • This field is for validation purposes and should be left unchanged.