GTmetrix Performance Blog

News, updates and guides on GTmetrix and general web performance

How to Use History Graphs

Last Updated:

In this guide, we’ll tell you all about GTmetrix History Graphs and how to use them.


 

 


 

Overview

GTmetrix users can view past reports generated through their account by opening any report and navigating to the History tab.

The History tab provides History Graphs to visualize your historical data as well as other options to keep track of your webpage’s performance.

In this guide, we’ll show you all the different ways in which you can use History Graphs.
 


 

Dashboard Reports Table

Before we discuss History Graphs in detail, let’s take a look at the basic Dashboard Reports Table functionality (logged-in users only).
 

The Dashboard Reports Table shows you all your latest reports ordered by how recently they were generated.

 
Each row of the Dashboard Reports Table displays the Last Report generated for a URL and the Analysis Options used in the test.

Here’s how the Dashboard Reports Table behaves:
 

  • Successfully analyzing a page for the first time will insert a new row for that particular URL/Analysis Options combination.
     
  • Testing the same page with different Analysis Options will insert a new row for that particular URL/Analysis Options combination.
     
  • Re-Testing the page with the same Analysis Options will overwrite the previous Last Report on that particular row.

 
More Dashboard Reports Table functionality is detailed in our How to Organize Reports with Dashboard Filters article.
 


 

History Graph Basics

In order to see a report’s History Graph, view a report and click on the History tab.
 

Click on the History tab to view previously generated GTmetrix Reports.

 
Note that you must have tested a page at least twice in order to generate report history for that page.
 


 

Available History Graphs

The History tab provides three graphs to visualize the historical report data. They are:

  • Page metrics graph – Displays 9 major metrics (e.g., TTFB, LCP, TTI, etc.).
  • Page sizes and request counts graph – Displays your page size and total number of requests.
  • Page scores graph – Displays your GTmetrix Grade/Performance/Structure Scores (PageSpeed/YSlow scores for Legacy Reports).

Each History Graph has a colour-coded legend below it, signifying what the data points are for that particular graph.

History Graphs are also synced in terms of interaction (panning, zooming, adding notes) i.e., performing an action on one graph applies the same action to the other History Graphs (except toggling legends).
 


 

Hovering on a Point on the Graph

To view a specific report, simply hover over a data point on any History Graph. A small box should pop up showing you when that report was generated, with three options below it.
 

Hovering over a data point reveals when that report was generated, and provides options to view, compare, or delete that GTmetrix Report.

 
Here’s what happens when you click on any of these options:

  • View Report – Opens that particular GTmetrix Report (You can also click on the point itself).
  • Compare to – Compares that particular report to the one you’re currently viewing.
  • Delete – Deletes that particular GTmetrix Report.

 
If you have a significant amount of historical data, you’ll instead find cluster points, which contain aggregated data for multiple reports. More on this below.
 


 

Loading More Reports

For performance purposes, GTmetrix will only load the first 1000 reports on the History Graph.

The number of reports (i.e., data points) shown on your History Graph will vary according to your plan level:
 


 

Basic (Free) Users

If you’re a Basic user, you can view up to 50 reports on your History Graphs.
 

Basic users can view up to 50 reports on History Graphs.

 
While Basic accounts have limitations to how many reports can be generated and retained, you can view upto 50 reports on a History Graph if it’s available (e.g., if the report was generated by a PRO user).

If even more report history is available (i.e., more than 50 reports), you’ll see the three dots on the left hand-side of the History Graph. You’ll need to upgrade to a PRO plan to load more reports.
 


 

PRO Users

For Micro, Lite, and Lite Plus plan users, GTmetrix History Graphs display the first 100 reports, by default.

For all other PRO users, GTmetrix History Graphs display the first 1,000 reports, by default. If more report history is available and you wish to load them, you can do so by clicking on the Load more reports button.

This button is found in two places:

  • Hover over the arrow seen on the left hand side of the History Graph
  • Under the History Date Range box

 

PRO users can click on the “Load more reports” button to load your entire report history.

 
Clicking on either button loads your entire report history.
 


 

History Graph Interaction

Now that you understand the basics of History Graphs, we can discuss History Graph interaction.
 


 

Toggling Legends (Page Metrics Graph only)

The Page metrics graph shows 9 different metrics. They are:

 
By default, all the metrics are active on the graph. You can click on any legend item to individually toggle it on or off so that you can choose which metrics you want to view on the graph.
 

You can toggle specific timings to appear on the History Graph.

 
When a legend item is toggled as inactive, it will appear greyed out and that metric won’t be displayed on the graph.
 

Toggling legend items on page metrics History Graph, showing difference between active and inactive metrics.

 
GTmetrix will also remember which legend items are active/inactive for future visits so that you don’t have to repeat this process.
 


 

Panning and Zooming

History Graphs are defaulted at the “All” zoom level, which displays your entire report history (or the first 1,000 reports if you haven’t loaded them all).

If you have a significant amount of reports generated for the page, you’ll find that reports may be aggregated into cluster points.

These cluster points have larger circles to indicate the availability of more than one report.
 

Cluster points appear larger according to the number of reports aggregated within them.

 
You can hover over any of the cluster points to reveal how many reports are available in that cluster.
 
Hover over a data point to reveal how many aggregated reports are available in the cluster point.

 
Hovering over a cluster point also shows you the average for that particular metric, along with minimum, maximum and average values.

Click on the cluster point itself or the Zoom in link for a closer look at the reports that were aggregated. You may need to zoom in more than once, depending on how many reports have been generated over that time period.
 

Note: When you zoom into one graph, the same effect is applied to the other graphs as well.

 

Zoom in for a closer look at reports in the cluster, and hover over a data point to focus on individual reports.

 
Once zoomed in, you can use the left and right arrows on the top-right of the History Graph to pan across different areas of the History Graph.
 


 

Zooming by Period

You can zoom by a specific period of time by using the Zoom buttons (1d, 1w, 1m, 3m, 6m, 1y, all) above each History Graph.

Each of these buttons represents a specific zoom level that corresponds to a period prior to the latest report.
 

Video showing the various zoom levels when the different buttons are clicked and using the pan arrows to show previous and next periods.

 
For example – 1d zooms in on the reports generated one day prior to the latest report; 1w zooms in on the reports generated one week prior, and so on.

Use the pan arrows to move forwards or backwards in date, depending on the zoom setting used.
 


 

Click and Drag Zooming

Manually zoom into a specific part of the History Graph by clicking and dragging over any section of the graph.
 

Clicking and dragging to manually zoom into to a part of the History Graph

 
You can do this multiple times to achieve finer zoom levels.
 


 

Zooming by Date Range

You can also find specific reports in a given time period by using the History Date Range box in the History tab.
 

Use the “From’ and “Until” boxes to display reports generated between those specific dates.

 
Select the desired “From” and “Until” dates, and GTmetrix will show you all the reports generated during that period.

By default, GTmetrix only displays the first 1000 reports in History Graphs. Click on Load more history* if you want to display the entire report history.

* Select plans only.
 


 

Adding Notes

You can add notes to any of the graphs on the History tab. These can be useful to track changes to your webpage’s performance, including fixes, issues, and updates.
To add a note, follow these steps:

1) Click on “Add Note” on any of the graphs

2) Click on any part of the graph, where you want to add the note
 

Click on Add Note, then click on any part of the graph where you want to add the note.

 
3) Type your note into the resulting text box, adjust the date and time as needed, and click on Save.
 
Type your note, adjust the date/time as needed, and click on “Save”.

 
And that’s it! Added notes will been seen across all History Graphs for convenient tracking.
 
Click on an existing note to edit or delete it.

 
You can also click on an existing note to edit or delete it.
 
 

Adding Notes to Multiple Reports (Global Notes)

PRO users can also bulk-add a note to multiple pages at the same time.

This is useful for adding a note that is common across multiple pages (e.g., site-wide updates, location-based campaign launches, etc.).
 

Select “Add Global Note” from the Bulk Action dropdown to bring up the Global Notes modal.<br />

 
We’ve written a separate guide on using Global Notes.

Note: Global Notes are only available to PRO users.

 


 

History Downloads

You can export your report history onto a spreadsheet (in .csv format), either by downloading your historical data in a .csv file, or generating a link to the CSV file (for use with external integrations like Excel, Looker Studio, Google Sheets, etc.).
 

The Export History Widget allows you to export your report history in spreadsheet format.

 
This history.csv file will contain data such as Report generation date (and time), Performance Metrics, Page Details, Browser Timings, etc.

You can select the time range of reports you wish to download, as well as which data columns you wish to display in the .csv file. Read our How to Export Report History guide to learn more.

Note: The maximum amount of historical data you can download matches how many reports are displayed on your History Graphs.

  • Basic users can download historical data for the first 50 reports.
  • PRO users can download your entire report history.

 


 

Summary

History Graphs are useful for viewing, comparing, and analyzing past performance data, and to keep track of your webpage’s performance history.

Use this guide to learn the different ways you can use these History Graphs, and consider upgrading to a PRO plan if you require longer report data retention or more History Graph visualization.

 


 

Frequently Asked Questions (FAQ)

Here are some common questions regarding History Graphs in GTmetrix.
 


 

What are GTmetrix History Graphs?

GTmetrix History Graphs let you visualize historical report data for a tested page. You can use them to review historical performance, compare results over time, and track the impact of website changes.


Who should use History Graphs?

History Graphs are useful for anyone who wants to monitor webpage performance over time, compare historical reports, track the impact of changes, and maintain a record of historical test results.


Where can I find the History Graphs?

To view History Graphs, open any GTmetrix report and click the History tab.


Why don’t I see any report history yet?

A page must be tested at least twice before report history can be displayed for that page.


What graphs are available in the History tab?

The History tab includes the following graphs:

  • Page metrics graph
  • Page sizes and request counts graph
  • Page scores graph

Each graph helps visualize a different part of your page’s historical performance data.


What does the Dashboard Reports Table show?

The Dashboard Reports Table shows your latest reports, ordered by how recently they were generated.

Each row represents a specific URL/Analysis Options combination.


What happens when I test the same page again?

If you test the same page again using the same Analysis Options, GTmetrix overwrites the previous Last Report for that row (past reports can be viewed in the History Graph).

If you test the same page using different Analysis Options, GTmetrix creates a new row for that combination.


What happens when I hover over a data point on a History Graph?

Hovering over a data point reveals when that report was generated and provides options to:

  • View Report
  • Compare to current Report
  • Delete Report

You can also click the point itself to open that report.


What are cluster points?

Cluster points appear when multiple reports are grouped together on the graph. This usually happens when there is a large amount of historical data in a given time range.

Hovering over a cluster point shows summary information, including the number of aggregated reports and minimum/maximum/average values.


How do I zoom in or pan across a History Graph?

You can zoom into History Graphs in several ways:

  • Use the preset zoom buttons (1d, 1w, 1m, 3m, 6m, 1y, all)
  • Click on a cluster point or the Zoom in link
  • Click and drag across a section of the graph
  • Use the History Date Range box to filter reports between specific dates

Once zoomed in, use the left and right arrows at the top-right corner of the graph to move through adjacent time periods.



Can I toggle metrics on or off?

Yes. In the Page Metrics graph, you can click legend items to toggle individual metrics on or off.

Inactive metrics appear greyed out and are hidden from the graph.


Does GTmetrix remember my selected metric view?

Yes. GTmetrix remembers which legend items are active or inactive for future visits.


Can I filter report history by date?

Yes. Use the “From” and “Until” fields in the History Date Range box to display reports generated within a specific date range.


Can I add notes to a History Graph?

Yes. You can add notes to track changes such as fixes, issues, releases, or updates that may affect page performance.

Pro-users can also add Global Notes to add the same note to multiple pages at once. This is useful for tracking site-wide changes or shared events across multiple monitored pages.


How many reports can users view on History Graphs?

Basic users can view up to 50 reports on History Graphs, if that report history is available.

For PRO users, it depends on your plan tier.

For Micro, Lite, and Lite Plus plans, GTmetrix displays the first 100 reports by default. For all other PRO plans, GTmetrix displays the first 1,000 reports by default.

If more reports are available, you can click Load more reports to load the rest of your history.


Can I export report history?

Yes. You can export report history as a CSV file or generate a CSV link for use with external tools such as Excel, Google Sheets, or Looker Studio.


What data is included in the history.csv export?

The exported history.csv file can include data such as:

  • Report generation date and time
  • Performance metrics
  • Page details
  • Browser timings

The exact columns included depend on the options selected during export.


Is there a limit to how much historical data I can download?

Yes. The maximum amount of data you can download matches the amount of history available on your History Graphs.

  • Basic users can download up to 50 reports
  • PRO users can download their entire available report history

 


 

Get more history visualization and longer data retention

Basic GTmetrix Splash

Keep track of your performance history and track trends over time.

Get more history visualization and longer data retention

Basic GTmetrix Splash

Keep track of your performance history and track trends over time.

Sign up for a Basic GTmetrix account for more historical tracking – It’s FREE!


Get Started for FREE

Upgrade to GTmetrix PRO and get more history visualization and longer report retention.


Upgrade to GTmetrix PRO today