> For the complete documentation index, see [llms.txt](https://docs.aisera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisera.com/aisera-platform/adding-data-to-your-tenant/data-ingestion/field-maps.md).

# Field Maps

Field maps define how data from an external **Data Source** is read into the Aisera platform and, optionally, written back to the origianal **Data Source (SOR)**, if it is specified as the publish target in the application/bot **Details** window.

## Field Mapping

If you are using one of the pre-mapped data sources (that you can choose from the **Settings > Data Integrations** and **Settings > Data Sources** commands in the Aisera Admin UI, the fields from that data source are already mapped from that source to the entities and fields within the Aisera Gen AI platform.

You can modify or create custom maps if you are using a Generic connectior or when you want to map custom fields to fields within the Aisera Gen AI platform objects. are configured per Data Source and can be found at the bottom of the **Data Source Details** page under **Settings > Data Sources**.

<figure><img src="/files/LBFmLy7lpyUFcOrcKdz0" alt=""><figcaption><p>Data Source Field Options</p></figcaption></figure>

The Aisera Gen AI platform provides two types of fields you can map:

**Standard Fields** are predefined Aisera platform fields. Out of the Box (OOTB) Data Sources come with standard fields pre-mapped to the Aisera Platform. You can add or modify these mappings as needed. See [New Field Mapping](/aisera-platform/adding-data-to-your-tenant/data-ingestion/field-maps/creating-new-field-maps.md) to connect a standard field to your Data Source.

**Custom Fields** are fields that you define for data that has no standard equivalent on the Aisera Platform. This could include data such as organization specific metadata, tags, or custom fields from your external systems. See [New Custom Field](/aisera-platform/adding-data-to-your-tenant/data-ingestion/field-maps/creating-a-custom-field.md) to map this data to the Aisera Platform.

Once configured, field mappings can be exported as backups or to replicate a configuration across multiple Data Sources. See [Export Fields Mappings](/aisera-platform/adding-data-to-your-tenant/data-ingestion/field-maps/exporting-field-mappings.md) and [Import Field Mappings](/aisera-platform/adding-data-to-your-tenant/data-ingestion/field-maps/importing-field-maps.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.aisera.com/aisera-platform/adding-data-to-your-tenant/data-ingestion/field-maps.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.
