> ## Documentation Index
> Fetch the complete documentation index at: https://docs.experio.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Data Mapping

> Map external data fields to your knowledge graph ontology

## Overview

Data mapping defines how raw fields from your external data sources are transformed into entities and relationships in the knowledge graph. Mappings tell Experio how to interpret structured data (CSV, Excel, databases) and create the corresponding graph nodes and edges.

Navigate to **Admin > Data Sources > Data Mapping**.

## Viewing Mappings

The data mapping page shows a table of all configured mappings with server-side pagination. Each entry displays the mapping name and configuration details.

## Creating a Mapping

Click **Create New Mapping** to open the mapping editor.

The mapping editor provides two modes:

### Form Builder

A step-by-step form interface for defining:

1. **Source Fields** — Select which fields from your data source to use
2. **Node Mappings** — Define how source fields map to entity types in your ontology
3. **Relationship Mappings** — Define how relationships between entities are derived from the data

### Visual Canvas

An interactive drag-and-drop canvas (powered by React Flow) for visually designing mappings:

* Drag source fields onto the canvas
* Connect fields to entity types and properties
* Draw relationship lines between entities
* Zoom and pan to navigate complex mappings

## Mapping Components

### Source Fields

Define the raw fields available from your data source. Each field has:

* **Field name** — The column or property name in the source data
* **Data type** — String, number, date, etc.

### Node Mappings

Map source fields to entity properties:

| Configuration        | Description                                        |
| -------------------- | -------------------------------------------------- |
| **Entity Type**      | Which ontology entity this maps to                 |
| **Property Mapping** | Which source field populates which entity property |
| **Identifier**       | Which field uniquely identifies this entity        |

### Relationship Mappings

Define how entities are connected:

| Configuration         | Description                             |
| --------------------- | --------------------------------------- |
| **Source Entity**     | The starting node of the relationship   |
| **Target Entity**     | The ending node of the relationship     |
| **Relationship Type** | The type of connection between entities |

## Editing and Deleting

* Click any mapping row to edit its configuration
* Use the delete action to remove a mapping

<Warning>
  Deleting a mapping does not remove entities or relationships already created in the knowledge graph. It only prevents future data from being mapped using that configuration.
</Warning>