The Mapping Assistant is a Sense feature that uses generative AI to quickly and easily create a mapping, using natural language prompts to automatically group pages together.
Common use cases
- Bulk-generate multiple page groups for a mapping
- The assistant quickly generates several Page Groups at once based on their broader purpose (e.g.: “fetch all checkout steps”).
- Create and manage multiple page groups for your mapping using simple prompts
- E.g.: “split my Product Listing pages by category” or “group all checkout pages”
- Create and group more complex page structures (that typically require regex)
- E.g.: “group all hotel pages that share the same pattern (any country)”
- Fine-tune your page groups with simple follow-up prompts
- E.g.: “Add”, “Group”, “Split”, and “Refine”
How the Mapping Assistant works
The Mapping Assistant takes a natural language prompt you give it - for example; an instruction, description, or context - and groups pages by their shared purpose or URL structure to help you create and refine a mapping.
What the assistant does with your prompt:
- Gives you a list of suggested page groups
- Each page group is pre-configured using your URL structure (with criteria that can include ‘path contains’, regexes, custom variables and more)
- Enables you to review and refine the mapping, using further prompts or by manually adding/editing page groups.
How the assistant groups pages
By structural pattern
For example, if you wanted to group hotel pages and they had the following URL structure, the assistant would automatically identify and group the URLs that follow a similar format.
- /es/hotel/espana/barcelona/hotel-name1
- /fr/hotels/jamaica/paris/hotel-name2
By their shared purpose
For example, if you wanted to group together promotional pages and they had the following URL structure, the assistant would automatically recognize and group pages that serve the same or similar intent.
- /offers/cards/best-credit-card
- /promotions/creditcards/premiumcard-world
Bulk-generating multiple page groups
The assistant quickly generates several page groups at once based on their broader purpose (e.g.: “fetch all checkout steps” or “group all pages by journey stage”).
Prompt guidelines
- Try to make your prompts as explicit as possible.
- Think about your analysis needs and how your site is structured, to help you define how you want the assistant to set up your mapping.
- For more complex page structures, include URL examples to help the assistant identify relevant pages.
- E.g.: “Group all hotel pages sharing the same pattern as [any country]:
/es/hotel/espana/barcelona/hotel-name1
/pt/hotel/portugal/faro/hotel-name2
/fr/hotel/france/paris/hotel-name3”
- E.g.: “Group all hotel pages sharing the same pattern as [any country]:
- Use suggested prompts (under the prompt box) to help you explore how the assistant creates page groups and generates page criteria for each one. The suggested prompts adapt with each prompt submitted and according to your site’s structure.
- Remember to review the results for accuracy and fine-tune as necessary.
Create a new mapping with the Mapping Assistant
AI feature activation
This feature requires an Admin user to have accepted the AI Service Schedule (if not done so already). Learn more about activating Sense features here.
There are currently two ways to create a mapping, manually or using the Mapping Assistant. Easily switch between your preferred method by enabling/disabling the Mapping Assistant toggle.
Ensure the toggle is enabled for the steps below.
1. Go to ‘Analysis setup’.
2. From the Mappings tab, select ‘New mapping’.
3. You have two options for creating your mapping:
Using AI prompts
In the text box, start typing your instruction with the types of pages you want to group together. For example, “Group pages by [enter page types]” and you’ll see suggestions appear, or you can continue typing your own.
Tip
Click on 'Suggested prompts' (the lightbulb icon) to view additional suggestions tailored to your site. (e.g., "Group product pages by brand", "Group checkout steps separately").
Add page by page manually
Click the ‘add manually’ link below the text box to create page groups one by one. (See how to add page by page below).
4. Press ‘Enter/Return’ to generate your mapping, or use the purple 'Generate' button (arrow icon to the right).
5. Review the suggested page groups.
The Mapping Assistant will return a table with page groups, tailored according to your prompt:
- Suggested page groups
- Traffic coverage percentage
- Number of pages included in each group
- Views from the last 3 days
- Category assigned to each group
6. Name your mapping. At the top of the window, click the ‘pencil icon’ and then click ‘Update’.
7. From this point, you can refine the mapping using Sense, manually or you can save your mapping with the results you have.
Note
AI can make mistakes. While we work to minimize these, you should always review the results for any inaccuracies or page group overlaps, and refine where necessary.
Review the mapping
After your mapping has been generated, you can review, refine, and expand it to ensure it accurately represents the structure you need.
Check traffic coverage
Review the metrics at the top to verify your mapping captures the right traffic:
- Traffic coverage - Percentage of total site traffic covered by these page groups
- Pages included - Number of individual pages across all groups
- Views last 3 days - Total views across all grouped pages
Search page groups
Use the search bar to quickly find and check whether a specific page group has been created.
Review and validate page groups
Click ‘Expand’ to see the top 5 pages in the page group and view counts for each page.
Click 'Show all pages' to view the full list.
As you review each page group, check for:
- Correct grouping - verify pages share a similar purpose or structure
- Misclassified pages - check for pages that don't belong
- Overlaps - pages that appear in multiple groups (see note below)
Add more page groups
To expand your mapping, you can either use the assistant or add pages manually.
Using the assistant
Enter a prompt describing the pages you want to add (e.g., "Add a page group for all cart pages"), then click ‘Generate’.
Adding manually
Click 'Add manually' and then refine the criteria.
To refine the mapping, or edit another existing mapping, follow the section below.
How to edit a mapping with the Mapping Assistant
Follow these steps to modify page groups in a new or saved mapping.
Important
If you edit a page group that's used in goals, segments, zonings, or dashboard widgets, your changes will impact those linked objects.
Step 1: Open the mapping
From the mapping capability
Click on an existing mapping, or a new mapping you're refining with the assistant.
You can edit or manage your mapping by adding a new page group or refining existing ones.
From other Analysis capabilities
Filter and view page groups from Funnels, Session Replay and Zoning Analysis.
View mappings from Journey Analysis and Page Comparator.
Step 2: Make you changes
Choose one of the following methods based on what you need to change:
Add a new page group
- Write in the edit box describing the new pages you want to add.
-
Press Enter/return or Click 'Generate'.
For example: Add a page group for blog pages.
Refine an existing page group
-
Click on the page group name.
-
Describe the changes you want to make.
- Click 'Generate'.
Example editing prompts
"Add pages with '/promo' in the URL to the Sales page group"
"Split the Product page group by product category"
"Remove all URLs containing 'test' from all page groups"
"Merge the Checkout and Payment page groups"
Tip
To rename a page group manually, click the page group name, click ‘Edit name’, enter the new name and click ‘Update’.
View your prompt history
This helps you track what you've already tried and refine your approach.
-
Click the prompt history icon.
- Review your past prompts for this mapping and the page groups they generated.
-
Click any previous prompt to reuse or modify it.
Note: You can see the prompt history for the mapping you are currently working on. Once you close or save, you will no longer be able to see the prompt history.
Edit the criteria manually
Add new criteria using "+ Add 'AND' criteria" or "+ Add 'OR' criteria"
You can change:
- How URLs are matched (for example “contains," "starts with," or "matches exactly”).
- Values (the specific text or pattern you are looking for).
- URL components (path, host, query or custom variables).
Step 3: Validate your changes
As you edit a page group, use the Pages panel on the left to validate any changes.
The Pages panel has two tabs that help you track your progress:
Included – Shows pages currently matching your criteria for this page group
- Displays the number of pages included (e.g., "Included 0" or "Included 23")
- Lists each matching page with its view count
- Updates in real-time as you modify criteria
Ungrouped – Shows pages that don't belong to any page group yet.
- Displays the total number of ungrouped pages across your entire site (e.g., "Ungrouped 1,051")
- Helps you identify which pages still need to be organized into groups
- Useful for finding pages you might have missed
Tip
Regularly check the Ungrouped tab to ensure you're capturing all relevant pages in your mapping. High-traffic ungrouped pages may indicate missing page groups.
Step 4: Save your changes
After you have made your changes:
- Click the back arrow to return to the mapping overview.
- Click "Save mapping" to apply all changes.
Manage page groups
Use these tools to organize and optimize your page groups. These actions can be performed at any time.
Merge page groups
When to use: You want to combine similar or duplicate page groups into one. For example, duplicate product page groups.
- Select the page group rows you want to merge. You will need to select at least two page groups.
-
Click ‘Merge’.
- Review the merge results.
- Click 'Save mapping' to apply the changes.
Duplicate a page group
When to use: You want to create a variation of a page group without starting from scratch.
- Click ‘Actions’ from the page group row you want to copy.
- Click ‘Duplicate’.
FAQs
Does the Mapping Assistant process personal data?
This feature is not indented to process personal data. However, you should be sure that your URLs do not contain personal data or any other sensitive personal information before using the Mapping Assistant. Learn more about masking your URLs in our technical documentation.
Why has the assistant returned no results to my request?
Depending on the complexity or ambiguity of the prompt, the assistant may not be able to return results. In this case, you can try breaking down your prompt into a simpler request, or attempt a more explicit prompt. Another reason could be that the pages the assistant is trying to group have had no views in the last 3 days, or that they don’t exist.
Why has the assistant suggested a non-existing page or custom variable?
Like many AI models, on occasion the assistant may experience what’s known as a hallucination and return an inaccurate result. It’s always worth reviewing your mapping results and adjusting if necessary.
Why has a page been added to more than one page group?
The assistant focuses on generating accurate page groups. However, AI can make mistakes and a page may appear in more than one group. You should review any page group overlaps and adjust if needed.