A page group is a set of pages on your website. You can customize experiences on your website based on visit patterns. For example, a news site might restrict recent articles to those who have subscriptions, while allowing anyone to read archived articles. Alternatively, visitors who frequent a certain topic (such as sports) might be nudged to sign up for the site's news feed for that specific topic.

Suppose you have a website with the following pages:

You could create page groups by month:

  • /news/2010-June/.*
  • /news/2010-July/.*

Alternatively, you could create groups by topic (e.g. /news/., /politics/.). You might also create a page group to represent all of those pages that can be freely visited (e.g. /about and /subscriptions). You can even create page groups of non-existent URLs to track certain actions of users (e.g. /login-failure).

A page group could be a single page (e.g. /login), or could include all of the pages that match multiple regular expressions.

How to count visits

Page groups within Gatekeeper also have the sophistication to count page visits by specific criteria. For example, suppose a user visits these pages in this order:

  1. https://example.com/news/2010-June/politics
  2. https://example.com/news/2010-July/politics
  3. https://example.com/news/2010-July/health
  4. https://example.com/news/2010-July/politics (revisiting a previously visited page)

Should the second visit to https://example.com/news/2010-July/politics count as a new page visit? What if, after visiting these pages, the user wanders off to another site, and comes again via a referral link (e.g. https://example.com/news/2010-July/politics?src=hotnews); should the last visit count as a separate page visit?

If you want each visit to count as a separate page visit, you can set "Count visits to" to "all pages." If you wanted to treat each unique URL as a separate page visit, but not count visits to the same unique URL (so, the two visits to https://example.com/news/2010-July/politics would count as one visit but https://example.com/news/2010-July/politics?src=hotnews would count as a separate visit), then you can set "Count visits to" to "unvisited pages." Finally, if you want to count visits to each unique article (ignoring any URL parameters), you can set "Count visits to" to "unvisited pages, excluding query string."


Currently, page groups are meant to only be created and updated through the web application. We would certainly consider opening programmatic interfaces so that client software can create and update page groups automatically.

A single page can match multiple page groups.

With the fundamental building blocks of visitor groups and page groups in mind, you can now proceed to learn about policies to govern interactions on your site.