Pages in Fullstory

Page definitions represent important destinations in a customer’s digital experience. Fullstory will automatically suggest page groupings and names using AI-suggested pages. You can also define pages manually or send page data using the API. Once pages are set up, anyone within your Fullstory organization can access pages across metrics, segments, journeys, and more.

Fullstory page definitions allow content to be grouped by common patterns and given a name. For example, take this URL:

www.cargocommercefs.com/p/special-blender-GHJAVMY/GR156560-2A

This is really an instance of a “Product Detail Page" with the following grouping:

www.cargocommercefs.com/p/*/*

Creating a definition for a Product Detail Page allows you to analyze customer behavior across all page URLs while excluding interactions from other pages in your analysis.

Pages settings page

Navigate to the pages settings page:

1. Click your account name in the top left.
2. Click Settings.
3. Under Data Management, click Pages.

These pages are used for search and page analytics across Fullstory, including visited page searches, click maps, scroll maps, segment cards, and page flow dashboards cards. You'll also see how users move between pages on your site when you build journeys to visualize user navigation.

The pages settings page will show you all pages that are currently defined as well as give you the opportunity to create new pages, both manually and by reviewing AI-suggested pages.

The search box supports searches for both page names and URLs. If you have a particular page that you’d like to create a definition for and want to check if there is already an existing rule, simply paste that URL into the search box and check for a match.

Defining pages in Fullstory

There are several approaches to defining pages in Fullstory, as well as a legacy approach that may appear in your account:

Approach	Source	Description	Best for
AI-suggested pages	User	Review AI-suggested pages directly within Fullstory.	Teams that want to minimize data management and quickly create pages for high-traffic areas.
User-defined (manual)	User	Define pages manually directly within Fullstory.	Teams that want increased control of page definitions without needing to rely on code changes.
Browser API	API	Pages can be defined via the browser API and includes the ability to set page properties.	Teams that want maximum control and intend to build data management into their development process.
Mobile API	API	Pages can be defined via the mobile API includes the ability to set page properties. Pages for mobile apps can only be created using the mobile apps API.	Teams that want to define pages for mobile apps must use the mobile apps API.
Learned Pages	ML	Legacy label for Learned Pages. See below.	N/A

The rest of this guide will mostly focus on user-defined page definitions. Refer to the documentation linked above for mobile and web API documentation.

Creating pages from AI suggestions

Fullstory will automatically suggest pages for you to review. Do the following to review AI-suggested pages:

1. Navigate to Settings > Data Management > Pages.
2. Click Suggested.

For each suggestion, you can take one of the following actions:

• Approve Suggested Page: Click the checkmark under Actions to approve the suggested page without needing to review it.
• Review Page Suggestion: Click into the suggested page to review it using the interface for defining pages. This will open the same dialog that's used to manually define pages, except that most of the content will be filled in automatically.

• Reject Suggested Page: Click the trashcan icon under Actions to reject the suggested page and remove it from your list.

  If you reject an AI-suggested page on the Suggested tab, the suggestion will go away. However, the page may reappear after a week has passed if it again meets the criteria for an AI-suggested page over the previous seven-day period.

How AI-suggested pages works

To scope your page-centered analysis to the right level of granularity, Fullstory uses machine learning to identify general URL patterns across similar page structures and group them into pages. This doesn’t require any instrumentation on your part. When reviewing pages, if you see brackets [ ] or asterisks * in the URL Rule for your Page Definition, that means that multiple URLs are grouped together into a single page.

Because Fullstory is constantly learning about your site’s URL and page structure patterns as your site is updated and traffic patterns change, the pages that Fullstory suggests will change over time. The data you see is always using our best fit clustering at the present time, based on historical trends. Fullstory checks for new or updated page suggestions once per day.

Example of how AI-suggested pages works

Imagine you are shopping for blenders on cargocommercefs.com. You could see two different URLs for blenders with different words on the page, but this page is the same Product Details Page.

The fact that multiple URLs have the same user interface structure allows Fullstory to interpret what parts of the URL are variable. Using that intuition, we can turn these URLs...

www.cargocommercefs.com/p/special-blender-GHJAVMY/GR156560-2A
www.cargocommercefs.com/p/other-blender-GHsdfVME/GR123301-1B
www.cargocommercefs.com/p/special-toaster-oven-BLEAVFM/BL133630-8Q

...into this AI-suggested page: 

www.cargocommercefs.com/p/*/*

In some cases, you want to roll up URLs that match a pattern into a single page, while analyzing more specific URLs separately. For example, say your site contains these four URLs:

www.cargocommercefs.com/promo-landing-page-1
www.cargocommercefs.com/promo-landing-page-2
www.cargocommercefs.com/promo-landing-page-3
www.cargocommercefs.com/cart

You might see that Fullstory's AI-suggested page algorithm has created the page:

www.cargocommercefs.com/*

This pattern combines those four URLs. You might choose to create a new page for:

www.cargocommercefs.com/cart

This will let you analyze the Cart page separately from the Promo Landing Pages. Data for pages is mutually exclusive and the more specific page will always outrank the others. So in this case, Cart data will not be rolled into

www.cargocommercefs.com/*

Disabling AI-suggested pages

You can opt out of AI-suggested pages by doing the following:

1. Navigate to Settings > Account Management > StoryAI Features.
2. Toggle Suggested Pages to Off.

Creating pages manually

Click the Create Page button at the top of the pages settings page to manually define a page. See Defining Pages for details.

Frequently Asked Questions

Why do I see adjusted time frames in Page Insights and Page Flow cards?

When new user-defined pages are created, their data is captured on a go-forward basis only. Therefore, if you look at a Click Map, Scroll Map or Page Flow card for that page and your original time period starts before the page was created, Fullstory will let you know that the data actually only goes back to the day the page was created.

Can a URL be mapped to multiple pages?

No, URLs will only get counted towards a single page. This allows you to compare and sort your list of pages without worrying that some page views are double counted. In the case there are two pages that could match to a URL, the more specific one will win. Put another way, the most specific rule will be the rule with the first most specific term, in order of path, fragment, domain.

For example, let's say you have these two pages:

• Product Details Page `https://cargocommercefs.com/p/*`
• Product Details Page - Special Blender `https://cargocommercefs.com/p/special-blender-GHJAVMY/`

Any visits to `https://cargocommercefs.com/p/special-blender-GHJAVMY/` will only be counted towards the Page Product Details Page - Special Blender because it matches the most specific rule.

What are Visited Pages vs Visited URLs, and when should I use each?

Simply put, “Visited URL” represents one singular URL whereas “Visited Pages” may represent a group of URLs that have similar URL patterns and page structures. 

When building a search, use “Visited URL” when you’re interested in sessions where a user visits specific URLs. Use “Visited Page” when you’re interested in sessions where a user visits similar types of URLS (i.e. Product Detail Pages). Check your page settings page to understand how similar-looking URLs are grouped for your site.

How can I search for pages?

You are able to search an entire URL of a page in Segments > Event Filters as one option. You can also type a portion of the URL (such as a keyword within it, for example) and this will populate your results. This allows you to more easily find the page you want to analyze in search, Page Flow or Journeys.

How long does it take for newly created AI-suggested pages to be generated?

Fullstory checks for new or updated pages once a day.

Is there a limit to the number of pages I can create?

There is a limit of 1,000 for API-defined and AI-suggested pages. If this limit is met, Fullstory will stop creating new AI-suggested pages for you to review. There is no limit on user-defined pages.

What if the page I'm trying to define is a URL with query parameters?

As of November 14th, 2024, it is possible to define pages in-app that include query parameters in the page definition. Alternatively, you can utilize our Set Page Properties API to define these pages instead.

Are Page Definitions retroactive?

No, page definitions are not retroactive. Any changes made to your page rules will apply to future sessions.

What happens when Page Definitions are archived?

When a page definition is archived, our machine learning algorithm for AI-suggested pages won't attempt to create a page definition that matches the archived page moving forward. Any existing sessions that aligned with the archived page definition will remain as it was originally indexed.

Archived pages can still appear in Metrics, Journeys, etc. for historical time ranges, but they won't match any future sessions. They'll still count towards your page limits. If you would like these pages deleted, please reach out to our Support team here. 

Why do I continue to see rejected pages after I’ve previously rejected them?

If you reject an AI-suggested page on the Suggested tab, the suggestion will go away. However, the page may reappear after a week has passed if it again meets the criteria for an AI-suggested page over the previous seven-day period.

How does using wildcards (* or **) affect which page rule a URL is mapped to?

URLs will only get counted towards a single Page definition. The page definition corresponding to a URL is determined by identifying the rule with the most specific term that occurs first in the positional order.

For example, if you have these two Pages:
*/product-details/product-number
www.yoursite.com/*/*

Any visits to www.yoursite.com/product-details/product-number would only be counted towards the www.yoursite.com/*/* page rule because when reading the URL, this rule has the first specific match without a wildcard.

What happened to Machine Learning (ML) pages and Learned Pages?

In October 2025, Fullstory migrated to AI-suggested pages, which is an iteration of what previously had been referred to as Learned Pages or Machine Learning (ML) Pages.

The introduction of AI-suggested pages brought more accurate page matches, automatic page names, and a revised user interface for managing suggested pages. Previously, ML pages were added automatically, whereas AI-suggested pages are curated and reviewed before being added.

What does it mean when I see a Page that is Not Defined?

When you see a Page that is Not Defined, we are grouping together page views for URLs that are not already defined as a Page in your Fullstory account. By default, Fullstory will create Learned Pages for your most commonly visited pages. We don’t automatically create Pages for all of your URLs so that your experience isn’t cluttered with Pages you don’t care about.

In order to find out what URLs are getting grouped into Not Defined, you can create a Dimensionality card in Metrics or Dashboards for events where the Visited Page = Not Defined, and Grouped by URL, URL Path, or URL Query Parameter.

You can add more Pages to capture that additional traffic in Settings > Data Management > Pages by clicking on “Create Page.” 

If you use Pages for Mobile Apps, you can follow similar steps to better understand what areas of your app are not instrumented and getting grouped into Not Defined. Create a Dimensionality card in Metrics or Dashboards for events where the Visited Page = Not Defined, and Grouped by App View Name.

Are Not Defined Pages searchable? 

Yes! You are able to search for Not Defined pages in Segments > Event Filters.