Overlay Bookmarklet (V2)
Note
This documentation covers the updated V2 of the Parse.ly Overlay, currently in Beta. For the V1 documentation, see this page.
The Overlay bookmarklet layers Parse.ly traffic analytics on top of your website. This enables you to view the performance of page real estate (“slots”) as well as the posts that these slots link to. It also displays historical performance for both slots, using clicks as the base metric, and posts, using familiar Parse.ly metrics like views, visitors, and engaged time.

Activate Overlay
To use Overlay, navigate to http://dash.parsely.com/to/settings/overlay and drag the “Parse.ly Overlay (Beta)” link into your bookmarks bar. If you are logged into the Parse.ly dashboard, you may still use the original Overlay with the old bookmarklet. If you don’t see a “Parse.ly Overlay (Beta)” bookmarklet, request access to the beta by contacting Parse.ly support.

The Overlay bookmarklet works with pages that:
- Are structured for custom content placement, such as your homepage or a section page.
- Contain links to content on the same site domain.
- Logged at least one page view within the last 10 minutes.
- Are a non-post per the metadata supplied to Parse.ly.
- Are not a Google AMP page.
While viewing this page, click your browser’s new bookmark to load Overlay.
To close the Overlay, hover over the green Parse.ly logo in the upper-left corner of the screen. From there, click the “X” icon that appears when you hover over the logo.
Overlay controls

The main Overlay controls are on the bottom centre of the page when the Overlay is active. From left to right, the controls display a [Metrics | Headline Tests] toggle, a metric dropdown selector, a time range selector, view options, and the sidebar toggle.
Metrics | Headline Testing toggle
Customers with headline testing enabled will have the ability to toggle between traditional post and slot metrics and headline tests. Both, active and past, headline tests are available for each applicable slot. The sidebar shows headline test results in “In progress” and “Ended” tabs. For more information on headline testing, see How Headline Testing Works.

Metric dropdown
The metric dropdown consists of two columns: a selection of metrics to display overlaid on the current webpage and in the sidebar listing, and, conditionally, comparison, date range, and display sub-options. There are eight Slot metrics to choose from—Click-through rate (CTR), Change in CTR, Historical CTR, % of page clicks, Change in % of page clicks, Historical % of page clicks, Clicks/interval, and Clicks/min. Furthermore, there are three Posts metrics to choose from—Views, Visitors, and Engaged Time.
Slot metrics
Slot metrics are exclusive to Slots, which are sections of page “real estate” that can, of course, be occupied my multiple stories within a given time range. You can see the posts or pages that Parse.ly has associated with a slot within the last 6, 12, or 24 hours by clicking on the slot “badge”—the colourful square that displays the slot metric—and looking at the “Content” section of the sidebar.
Slot metrics can be shown as either an absolute metric or a relative ranking amongst other slots on the page. For historical metrics, like “Historical CTR”, you can select whether to see a historical average or to compare the currently selected time window with the same window a number of days in the past. For “change” (delta) metrics like “Change in CTR”, you can additionally select whether to display the change as an absolute percentage increase or decrease (a percentage point) or a percentage increase or decrease relative to the baseline.
Slots metrics can also be displayed for slots that do not link to posts or pages—like nav menu links, “open comments” links, or “back to home” links—by toggling “Show non-post links” in the view settings (see “View settings” below).
Post metrics
Post metrics are exclusive to Posts/Pages, and are associated with whatever post or page is currently occupying the slot. For posts, you can select between views, visitors, and engaged time, and you may also select whether to filter by referrals from the current page or not. Finally, for the views metric, you may also filter by device type (desktop, tablet, or mobile).
Non-comparison metrics
When viewing non-comparison metrics (Click-through rate (CTR), Historical CTR, % of page clicks, Historical % of page clicks, Clicks/interval, Clicks/min), you may see the following color scale after you’ve enabled the Overlay:
#95E36E (good — high)
values interpolate across this range
Non-comparison metrics time range
When viewing non-comparison metrics, you may select: 5m, 10m, 30m, 1h, 2h, 4h, or 6 hours of data from the time range menu. This time range will affect the Slots data that is located beneath this menu and it will affect the values that you see in the badges of the Overlay display.
Comparison metrics
When viewing comparison metrics (Change in % of Page Clicks, Change in Click-through Rate), you may see this broader color scale after you’ve enabled the Overlay:
#F7F09B (flat — within ±0.5pp)
#95E36E (improving — above +0.5pp)
Time range dropdown
The time range dropdown allows you to filter displayed metrics by the selected time period, ranging from the last 5 minutes to the last 6 hours.
View settings
The view settings allow you to set the zoom level of the current page, and whether to fade the page content in order to make the slot outlines more visible.
“Show non-post links” also allows you to toggle click metrics, like Click-through rate, on all links on a page, like section links or your “back to home” link, rather than just links to posts and pages.
Overlay sidebar
The overlay sidebar can be shown or hidden with the rightmost toggle on the Overlay controls panel. By default, the sidebar will display information about the current page, including top-level metrics, a time series graph of views, and bar graphs of the page’s top referrers and device breakdown. In addition, the “Ranking” tab will show an ordered listing of the current slots or posts, ranked by the currently selected metric. Clicking on the “target” icon (⌖) displayed on the right side of each hovered row will scroll directly to the relevant slot or page/post border.
When selecting a slot or post by clicking on the relevant badge—the colorful metric rectangle associated with a highlighted slot—the sidebar will display relevant metrics about that particular slot or post.
Last updated: July 30, 2026





