Use On-Page Variables

Custom variables (built-in)

These variables are available automatically on every website with the tracking code installed - no setup required. Use them in Personalization experiments, or Surveys, on every subscription type.

How to use them

In the Visual Editor, click the text element you want to personalize, then choose Edit Content. Insert any of the variables below directly into your text.

The text editor with a list of custom variables to insert

Available variables

Variable

Description

{COUNTRY}

The visitor's country. Accuracy: 100%.

{REGION}

The visitor's region. Accuracy: 80%.

{CITY}

The visitor's city. Accuracy: 70%.

{REFERRER_DOMAIN}

The domain of the referring website (e.g. google.com for www.google.com). Empty if the visitor arrived directly.

{VIEWS_SESSION}

Number of pageviews in the current session (e.g. 45).

{DAYS_SINCE_FIRST_VISIT}

Days since the visitor's first visit, counted from when the tracking code was installed (e.g. 7, can be 0).

{DAYS_SINCE_LAST_VISIT}

Days since the visitor's last visit (e.g. 14, can be 0).

{BROWSER_NAME}

Detected browser: Firefox, Chrome, Safari, Opera, Mozilla, Explorer, Netscape, Camino, OmniWeb, iCab, or Konqueror.

{BROWSER_VERSION}

Detected browser version (e.g. 11, 30).

{DEVICE_TYPE}

Detected device type: desktop, mobile, or tablet.

{OS}

Detected operating system: Windows, iOS, Mac, or Linux.

{IP}

The visitor's IP address (e.g. 45.221.56.78).

{ONLINE}

Number of real-time visitors currently on the page.

On-Page Variables (custom setup)

An On-Page Variable is a piece of your own page's content - like a cart total, a product name, or a price - that you extract and turn into a reusable text variable for A/B tests, Personalization experiments, or Surveys.

Example: capturing the cart total

  1. Add a product to your cart, right-click the page, and select View page source.

  2. Copy the full source code of your cart page.

  3. In Explore, go to On-Page Variables and create a new variable.

The On-Page Variables creation screen

  1. Click upload your own HTML and paste the source code you copied.

  2. Select the specific piece of content you want to capture - in this example, the element that shows the total cart amount.

Selecting the element that returns the total cart amount from the pasted HTML

  1. Name your variable and save it.

Note

This same process works for any piece of content on any page - not just the cart total. The cart total is just one common example.

Good to know

  • You can create and use multiple On-Page Variables on the same page.

  • Explore reads the variable's value based on its position on the page. If the page's structure changes, the variable may no longer be readable, and you'll need to recreate it.

  • Only display experiments using this variable on pages where the variable is actually present.

Note

Once created, you can also use an On-Page Variable to segment visitors within an experiment, not just to personalize text.

Related articles

Updated