What is a mapping?
The CS tag collects UX data on your site’s pages. Mappings let you organize this data.
Thanks to mappings, you can decide how you want to access the collected data on each page of your site. Do you want to see data on each page individually, or get aggregated data on pages of the same type, like a product page?
Mappings are built of your site’s pages that you organize through conditions into page groups.
Page is a unique element of a mapping and can’t be put into two page groups in the same mapping.
How to set up a mapping
There are currently two ways to create and refine a mapping, manually or using the Mapping Assistant. Easily switch between your preferred method using the 'new mapping assistant' toggle.
Either way, you can start by doing one of the following:
- Create a new mapping if you need to create a new mapping from scratch.
- Edit an existing mapping if you need to add new pages.
- Duplicate an existing mapping if you need to customize a mapping according to your analysis needs.
Access mappings
Go to 'Analysis setup' from the main menu and click on 'Mappings'.
Mappings list
When you select Mappings from the menu, you will land on the Mappings list interface. Here you will find all the existing mappings on your project.
List of all existing mappings on your project
1. Reference mapping (this can be referred to as Global mapping) - this is an example of a Global mapping, which is your go-to mapping. Learn more about different types of mappings for your team.
2. Number of page groups - a page group contains your site’s pages following the same template, like product pages or category pages. You can group similar pages to access aggregated data on the same page template.
3. Last updated - date and name of the last user who edited the mapping.
4. Exhaustivity - when a mapping is 100% exhaustive, this means that all the traffic on your site’s pages is included.
5. Glossary - here you can find all the definitions for mappings.
AI generated starter mappings
Note: Available to all new projects created from the 1st September 2025. In order to access these mappings you must accept the AI Service Schedule (if not already accepted for other AI features). Learn more about how to activate our AI features.
To help you get started, two ready-to-use mappings are generated for you using AI. To generate these, the AI will:
- Categorize your most visited pages, from the last three days, using URLs and custom variables
- Define the page conditions
- Assign page group names and associate the groups with categories
Once generated, the following mappings will be available for you to edit and refine, or begin using in your analyses right away:
- High-level mapping: A high-level view of your user journey (e.g.: Homepage, Product, Checkout).
- Detailed mapping: A more detailed breakdown (e.g.: Checkout Step 1, Product Listing – Glasses, Product Detail – Women).
Note: AI can make mistakes. Page group conflicts can occur and if starter mappings cannot be created you can create new mappings yourself.
Edit or delete the AI generated starter mappings
To edit either of these mappings, click the three-dot menu followed by ‘Edit’. Follow the usual steps to edit a mapping.
To delete either of these mappings, click the three-dot menu followed by ‘Delete’. To permanently delete all data associated with these mapping please contact your Customer Success Manager.
Why does your team need different mappings?
Depending on your unique job roles (marketing, design, merchandising, etc.), your team might need to set up several mappings on your account. This way you can all carry out an analysis according to each project’s scope.
If you need a high-level data overview on your pages, you should use a Global reference mapping. This type of mapping provides an aggregated data view on pages with the same type, like product or list pages.
If you’re an e-commerce Manager on your team, you might want to use Detailed category pages mapping. This way you can see data filtered out for specific pages that are not grouped together.
An example of mapping with separated product pages.
Using mappings in Experience Analytics
The mappings you select while using Contentsquare determines how your site's pages are being analyzed. For example, if you want to focus on different product pages of your site, choose a mapping where the product pages have been organized into separate page groups.
Journey Analysis
The customer journey will update according to the mapping you select:
In the example above, we used a Reference mapping. In this mapping, we haven’t parsed out different product pages. This means that a product page on the journey analysis visualization aggregates data collected on all product pages on your site.
Page Comparator
The list of page groups will update according to the mapping you select:
Glossary
| Page | Your site’s page built of a host, path and query. |
| Page group | One or more pages organized together into a page group through conditions. |
| Page conditions | Conditions allow you to organize your site’s pages into page groups. You can’t assign the same page to two different page groups. Build page groups through specific conditions to avoid page conflicts in your mapping. |
| Custom variable | It is an additional parameter that can be added to your page. It is usually pushed with a data layer. This info can be used to create page groups. Learn more |
| Linked objects | Assets that you create using a page group from a mapping, like segments, goals, zonings, alerts. |
| Page conflict | If you try to create a page group with a page that is already included in another page group, this will create conflict. A page can only belong to one page group. You will have to fix the conflict to save your mapping. |
FAQs
Why do my AI generated starter mappings have low exhaustivity?
While these AI generated starter mappings aim to be as exhaustive as possible, their exhaustivity can be impacted by the URLs' low pageviews, interest or relevance.
Do AI starter mappings process personal data?
While this feature does not intend to process personal data, you should ensure no personal data is inadvertently input, nor is it contained within any of the URLs used.
Which AI models is Contentsquare using?
Please refer to our AI Model List for information on the models used for each generative AI feature in the Contentsquare platform, as well as Contentsquare’s Sub-processors List for more information about what data is processed by Contentsquare AI feature.
Where can I learn more about the Privacy, Security and compliance of Contentsquare’s AI features?
Please visit our Trust Portal for further details.
How can I share the AI Service Schedule with my legal team for review?
You can share the direct link to the AI Service Schedule here: https://contentsquare.com/legal/service-schedule-cs-ai