# User Mapping

The **User mapping** feature in Hub88's Operator Backoffice enables operators to view and bulk match users in their system to the corresponding IDs in the Supplier’s system. This is a crucial tool for synchronising user data across platforms, ensuring accurate tracking and reporting.

User mapping can be accessed from the **Tools** section in the Operator Backoffice.

***

### **Filtering and viewing data**

By default, the User Mapping page displays all available unfiltered data. From this main view, you can apply filters to view specific data. The available filters are:

* **Operators**
* **Certain Operator user**
* **Suppliers**
* **Certain Supplier user**
* **Supplier currency**

You can easily access each user's behavioural data directly from the User Mapping section. Simply click the **view icon** at the end of the row to access more detailed information. The data reporting views include:

* KPI Overview per user
* Overview by Supplier
* Overview by Game

***

### Mapping multiple users — filter with user lists

You can map multiple users at once by filtering IDs in bulk. To do this:

1. Click on **‘Filter with user list’**.
2. Select the ID type (either **Supplier** or **Operator**) to filter by.
3. Choose the method for finding the IDs.

There are two available methods for entering or uploading User IDs:

**Method 1: Manual entry**

* In **Method**, select **‘Enter user IDs’**.
* Add the User IDs one by one, separated by commas or spaces, in the input field.

**Important:** Some Supplier User IDs contain spaces within the ID itself. In such cases, it’s recommended to use the **CSV upload method** to avoid errors during manual entry.

**Method 2: CSV file upload**

* In **Method**, select **‘Upload CSV file’**.
* Upload a CSV file (max 2 MB) containing the list of User IDs. Ensure that the User IDs are placed in a single column.
* You can download a **template** to use as a sample file.

***

### Viewing the results&#x20;

The display of results depends on the input method you selected:

**Manual entry**

For manual entry, you need to ensure that an **Operator** and **Supplier** are picked. Then you'll be able to click the “Receive CSV” button, which will trigger an email being sent to you, with a link to download the mapped users' CSV file.

**CSV file**

If you chose the option to upload a CSV file, an email with a link to download the mapped users' CSV file was sent to you.&#x20;

***

### Uploading incorrect data

If any of the entered or uploaded User IDs are incorrect, you will receive an error message detailing which IDs could not be filtered. An example of the error message is:

*Error. The following users were not found.*&#x20;

*user\_123, user\_007*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hub88.io/operator-backoffice/user-mapping.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
