Title: Overlay Bookmarklet (V2)
Author: joshua
Published: July 24, 2026
Last modified: July 30, 2026

---

 1. [User handbook](https://docs.parse.ly/user-handbook/)
 2. [Tools and features](https://docs.parse.ly/user-handbook/tools-features/)
 3. Overlay Bookmarklet (V2)

#  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](https://docs.parse.ly/user-handbook/tools-features/overlay/)._

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.

[[

Overlay allows easy tracking of webpage slot and post performance.

## Activate Overlay

To use Overlay, navigate to [http://dash.parsely.com/to/settings/overlay](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](https://support.parse.ly/hc/en-us).

![](https://docs.parse.ly/wp-content/uploads/sites/5/2026/07/SCR-20260730-irew-1024x733.
png)

Dashboards enrolled in the beta program will contain the Parse.ly Overlay (Beta)
link.

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, displayed at the bottom of the screen.

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](https://docs.parse.ly/user-handbook/dashboard/optimization-menu/headline-testing-tab/)
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](https://docs.parse.ly/user-handbook/dashboard/optimization-menu/headline-testing-tab/headline-testing-process/).

![](https://docs.parse.ly/wp-content/uploads/sites/5/2026/07/image-6.png)

### 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](https://en.wikipedia.org/wiki/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](https://docs.parse.ly/user-handbook/tools-features/overlay/#enable-overlay)
the Overlay:

  #F7F09B (okay — low)
  #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](https://docs.parse.ly/user-handbook/tools-features/overlay/#enable-overlay)
the Overlay:

  #C31308 (declining — below −0.5pp)
  #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 sidebar, when loaded on a homepage.

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.

[[

Hovering over a ranked item will reveal a target icon to aid with locating it on
page.

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