There’s an elephant in the room that we’ve been ignoring for years:
window.onload is not the best metric for measuring website speed
We haven’t actually been “ignoring” this issue. We’ve acknowledged it, but we haven’t coordinated our efforts to come up with a better replacement. Let’s do that now.
window.onload is so Web 1.0
What we’re after is a metric that captures the user’s perception of when the page is ready. Unfortunately, perception.ready() isn’t on any browser’s roadmap. So we need to find a metric that is a good proxy.
Ten years ago, window.onload was a good proxy for the user’s perception of when the page was ready. Back then, pages were mostly HTML and images. JavaScript, CSS, DHTML, and Ajax were less common, as were the delays and blocked rendering they introduce. It wasn’t perfect, but window.onload was close enough. Plus it had other desirable attributes:
- standard across browsers -
Window.onloadmeans the same thing across all browsers. (The only exception I’m aware of is that IE 6-9 don’t wait for async scripts before firingwindow.onload, while most other browsers do.) - measurable by 3rd parties –
Window.onloadis a page milestone that can be measured by someone other than the website owner, e.g., metrics services like Keynote Systems and tools like Boomerang. It doesn’t require website owners to add custom code to their pages. - measurable for real users – Measuring
window.onloadis a lightweight operation, so it can be performed on real user traffic without harming the user experience.
Web 2.0 is more dynamic
Fast forward to today and we see that window.onload doesn’t reflect the user perception as well as it once did.
There are some cases where a website renders quickly but window.onload fires much later. In these situations the user perception of the page is fast, but window.onload says the page is slow. A good example of this is Amazon product pages. Amazon has done a great job of getting content that’s above-the-fold to render quickly, but all the below-the-fold reviews and recommendations produce a high window.onload value. Looking at these Amazon WebPagetest results we see that above-the-fold is almost completely rendered at 2.0 seconds, but window.onload doesn’t happen until 5.2 seconds. (The relative sizes of the scrollbar thumbs shows that a lot of content was added below-the-fold.)
![]() Amazon – 2.0 seconds (~90% rendered) |
![]() Amazon – 5.2 seconds (onload) |
But the opposite is also true. Heavily dynamic websites load much of the visible page after window.onload. For these websites, window.onload reports a value that is faster than the user’s perception. A good example of this kind of dynamic web app is Gmail. Looking at the WebPagetest results for Gmail we see that window.onload is 3.3 seconds, but at that point only the progress bar is visible. The above-the-fold content snaps into place at 4.8 seconds. It’s clear that in this example window.onload is not a good approximation for the user’s perception of when the page is ready.
![]() Gmail – 3.3 seconds (onload) |
![]() Gmail – 4.8 seconds (~90% rendered) |
it’s about rendering, not downloads
The examples above aren’t meant to show that Amazon is fast and Gmail is slow. Nor is it intended to say whether all the content should be loaded before window.onload vs. after. The point is that today’s websites are too dynamic to have their perceived speed reflected accurately by window.onload.
The reason is because window.onload is based on when the page’s resources are downloaded. In the old days of only text and images, the readiness of the page’s content was closely tied to its resource downloads. But with the growing reliance on JavaScript, CSS, and Ajax the perceived speed of today’s websites is better reflected by when the page’s content is rendered. The use of JavaScript and CSS is growing. As the adoption of these dynamic techniques increases, so does the gap between window.onload and the user’s perception of website speed. In other words, this problem is just going to get worse.
The conclusion is clear: the replacement for window.onload must focus on rendering.
what “it” feels like
This new performance metric should take rendering into consideration. It should be more than “first paint”. Instead, it should capture when the above-the-fold content is (mostly) rendered.
I’m aware of two performance metrics that exist today that are focused on rendering. Both are available in WebPagetest. Above-the-fold render time (PDF) was developed at Google. It finds the point at which the page’s content reaches its final rendering, with intelligence to adapt for animated GIFs, streaming video, rotating ads, etc. The other technique, called Speed Index and developed by Pat Meenan, gives the “average time at which visible parts of the page are displayed”. Both of these techniques use a series of screenshots to do their analysis and have the computational complexity that comes with image analysis.
In other words, it’s not feasible to perform these rendering metrics on real user traffic in their current form. That’s important because, in addition to incorporating rendering, this new metric must maintain the attributes mentioned previously that make window.onload so appealing: standard across browsers, measurable by 3rd parties, and measurable for real users.
Another major drawback to window.onload is that it doesn’t work for single page web apps (like Gmail). These web apps only have one window.onload, but typically have several other Ajax-based “page loads” during the user session where some or most of the page content is rewritten. It’s important that this new metric works for Ajax apps.
ball rolling
I completely understand if you’re frustrated by my lack of implementation specifics. Measuring rendering is complex. The point at which the page is (mostly) rendered is so obvious when flipping through the screenshots in WebPagetest. Writing code that measures that in a consistent, non-impacting way is really hard. My officemate pointed me to this thread from the W3C Web Performance Working Group talking about measuring first paint that highlights some of the challenges.
To make matters worse, the new metric that I’m discussing is likely much more complex than measuring first paint. I believe we need to measure when the above-the-fold content is (mostly) rendered. What exactly is “above-the-fold”? What is “mostly”?
Another challenge is moving the community away from window.onload. The primary performance metric in popular tools such as WebPagetest, Google Analytics Site Speed, Torbit Insight, SOASTA (LogNormal) mPulse, and my own HTTP Archive is window.onload. I’ve heard that some IT folks even have their bonuses based on the window.onload metrics reported by services like Keynote Systems and Gomez.
It’s going to take time to define, implement, and transition to a better performance metric. But we have to get the ball rolling. Relying on window.onload as the primary performance metric doesn’t necessarily produce a faster user experience. And yet making our websites faster for users is what we’re really after. We need a metric that more accurately tracks our progress toward this ultimate goal.






[...] you what’s driving the web performance conversation right now. Elsewhere, he argues that performance metrics should capture render time.* Strangeloop unveils 12 bold predictions affecting web performance in 2013.* 24 Ways insists that [...]
[...] Performance-Papst Steve Souders schreibt im Performance-Calendar über “window.load()“. Bei UXMas steht heute Barrierefreiheit im Zentrum, auch wenn es offiziell über Design [...]
[...] The onload of Web 2.0 Why onload doesn’t represent user perception well and we should adopt a new standard. [...]
At RUMAnalytics we’re focusing entirely on metrics centered on serving the page to a visitor.
Isn’t it safe to assume that “first paint” happens shortly after DOMContentLoaded event is fired (document fully loaded, not parsed).
In that case we already have a decent approximation of first paint. Not as reliable (and cross-browser) as window’s “load” event, of course.
kangax: It’s certainly not true that “first paint” *always* happens close to DOMContentLoaded. For example, this test page has an image, a 10-second script, and an image in that order. The image is painted immediately, then the rest of the page (and DOM) is blocked for 10 seconds, and finally the second image is painted. So “first paint” was around the 0.0 mark, while DOMContentLoaded was around 10.0 – very far apart. (You can use my mobile perf bookmarklet to see the DOMContentLoaded time from Nav Timing, or simply look at window.performance.timing.) It’s possible that “first paint” and DOMContentLoaded are *generally* close together, but I haven’t seen any data one way or the other. I would bet that most webpages have scripts in the page that delay DOMContentLoaded thus making it a poor proxy for “first paint”.
[...] Steve pointed out in an earlier post, window.onload is not the best metric for measuring website speed. It is a convenient metric, and a [...]
As DOMContentLoaded is an event indicator which tells the DOM Tree is built. Can we use DOMContentLoaded as a proxy for improving performance of a website ? What is your opinion ?
Have you tried just correlating the DOM events with ATF percentages?
[...] for more information.) As we move to Web 2.0, with pages that are richer and more dynamic, window.onload is a less accurate representation of the user’s perception of website speed. Speed Index better reflects how quickly the user [...]
[...] initiates the request for the page to the time that window.onload fires. Many people, including myself, have pointed out that window.onload is becoming less representative of a web page’s [...]
[...] initiates the request for the page to the time that window.onload fires. Many people, including myself, have pointed out that window.onload is becoming less representative of a web page’s perceived [...]
An interesting discussion is value comment. I believe that you must write more on this subject, it might not be a taboo subject however usually persons are not sufficient to speak on such topics. To the next. Cheers