🚀 This is an early access feature
Mapping a dataset is a crucial step in preparing your dataset for downstream functionality such as project creation.
Mapping creates transparency between:
Your intended use of the dataset
Omnisient’s expectations for how the dataset should be structured (required columns and recommended additional columns)
Where to find Dataset Mapping
Dataset mapping is available in the following areas of the platform:
Location | How to access it |
My Datasets → Unregistered & Available datasets | Dataset row context menu → Map Dataset (also available from the dataset detail view)
 |
Own Data Preparation | Via the Dataset Mapper widget
 |
🔐 Permissions
Dataset mapping is enabled by default for Admin users.
Non-admin users can access the Dataset Mapper if they are assigned the permission.
How Dataset Mapping works
When you open the Dataset Mapper from either entry point, a bottom sheet will open with a two-step flow:
Select
Map
Step 1: Select
In this step, you choose the dataset you want to map and assign its dataset type.
Dataset selection behavior
Entry point | Behavior |
My Datasets | The dataset dropdown is pre-populated with the selected dataset |
Own Data Preparation | The dataset dropdown displays all Unregistered and Available datasets within your organization.
To make it easier to differentiate dataset states, the dropdown includes an icon next to each dataset indicating whether it is Unregistered or Available. |
📚 Dataset types determine which fields are required and which additional fields are recommended during mapping. You can view supported dataset types and mapping requirements here.
Step 2: Map
After selecting the dataset and dataset type, Step 2 will automatically populate with the mapping fields for that dataset type. These fields are grouped into:
Required fields
Additional fields
Required vs Additional fields
Field type | Required to save | Notes |
Required fields | ✅ Yes | Must be mapped for the dataset mapping to save successfully. |
Additional fields | ❌ No | Strongly recommended to maximize the usefulness of the dataset. |
⭐ Recommendation
While only required fields must be mapped, we highly recommend mapping additional fields as well to get the most out of your dataset.
Data Type icons
Each mapping field is paired with an icon representing its data type.
Use these icons to quickly confirm that you're mapping a dataset column to the correct field type and to ensure your mapping is consistent.
Icon | Dataset Type |
 | Boolean |
 | Datetime |
 | Decimal |
 | Integer / Number |
 | String |