AngularJS and SEO – Part 1 – Get your JS site indexed

In this series we will go through a few steps on how to make your AngularJS site crawlable by google and other search engines.
Note: This part does apply to Knockout, Backbone and other frameworks to.

First, there are a few misconceptions floating around on how this works, lets clear those out first:

Google bot can run javascript and you don’t have to do anything in order to make your site crawlable!

Yes, No or Maybe.

The article about google beeing able to read FB and Discqus comments, this does not mean google bot can execute javascript, it could be that googlebot simply is hardcoded to handle FB and Discus comments in some special way.

For this series we can safely say that googlebot and bingbot does NOT execute AngularJS and you will have to deal with this manually

HTML5 and Push state will make your site crawlable by google.

NO, _server side delivered content_ will make your site crawlable, some push state based sites do generate their main content server side using PHP, ASP.NET or NodeJS and deliver the initial content that way.

Thus, the content is available for googlebot to crawl.

The fact that there is push state and javascript involved on the client side is completely beside the point, server side content and URL’s that resolve is what matters.

Google and bingbot supports a technique or hack in order to make javascript driven sites crawlable.

If you use HashBang URLs. e.g.!/profile
The search bots can replace the hashbang with ?_escaped_fragment_=
Thus turning the above URL into an “Ugly URL” :

This way, your server can intercept the request and deliver a static snapshot of your dynamic content.
You will have to add some code or configure your webserver in order to make this work. but it does work and that is what is important.

We (Wombit) have released a free service for this purpose.
You can find it here:
When used, it will use a virtual browser to read the dynamic content of your website and capture the DOM that has been generated.
This result will then be returned to you from our servers.
You can then either store this as static snapshots on your own server, or, simply return it to google bot directly upon request.

Lets see how this can be done (using ASP.NET MVC4)

public ActionResult Index()
    string fragment = Request.QueryString["_escaped_fragment_"];

    //if the fragment is present
    if (fragment != null)
        //build an url that should be scraped
        //this example assumes that you use hashbang #! url's
        string url = string.Format("http://{0}/%23!{1}", Request.Url.Authority ,fragment);

        var snapshotUrl = string.Format("{0}",url);
        //ask Wombit.Crawler for the dynamic content
        using (var client = new WebClient()) // WebClient class inherits IDisposable
            var content = client.DownloadString(snapshotUrl);
            return Content(content);

    //return the view for our single page app
    return View();

This way, when google bot asks for an “ugly URL”, your server will return a HTML snapshot from the Crawlr service.
And that is all you need in order to get your AngularJS/Knockout/Backbone/React site in the google and bing index.

That said, there are plenty of other things you need in order to rank well, but this will get you indexed.


  1. Thanks, A very useful information .

  2. blah says:

    What about pages that are generated without a hash? So at the root url a page loads and then via ajax loads the content?

  3. Mead42 says:

    you would use the metatag meta name=”fragment” content=”!” for pages without hash based URLs

  4. This is very useful info, thanks for providing the MVC example!

  5. lyonesgamer says:

    I’ve been trying to figure out if there’s a way I can do this with Dropwizard, but it seems to be a bit difficult.

    Anyone who’s familiar with Dropwizard, if you see this, do you have any advice? I’m serving the Angular site with an AssetsBundle, so it’s handling all of the data for me…

  6. keniled says:

    Roger: is offline (522 Clouflare error page is displayed). Is it offline permanently or you need to hit some button to make it work?

  7. Hi Roger, your way is seem good. I develope another way, maybe you want check it.

Leave a Reply to lyonesgamer Cancel reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s