# Field Mapping

> Matching the fields of one app to the fields of another.

**Field:** Software Development  
**Category:** Integration & Automation  
**Also known as:** Data Mapping, Field Map, Map Fields

## Think of it like

Think of it like matching socks. Each sock from one pile finds its partner in the other pile.

## Definition

Field mapping says which field in one app fills which field in another. Two apps rarely use the same names. One app may say email, and the other may say email_address. A map lines them up, one pair at a time. It can also split or join values, like one full name into a first and a last name.

## Example

Lucy maps the shop's email field to the list's address field. She also splits full name into a first and a last name.

## Example code

```json
{
  "email": "email_address",
  "full_name": ["first_name", "last_name"],
  "country": "country_code"
}
```

Each field on the left fills the field of the same row on the right.

## Why it matters

A wrong map puts data in the wrong place. Phone numbers end up in the name field, and nobody notices for weeks.

## Common mistake

Mapping only the fields you see in one test. Empty or odd values in real data then break the run.

## Three principles

- **One pair at a time.** Each source field has one home.
- **Change the shape.** Split, join or reformat while you map.
- **Test real data.** Try empty and strange values too.

## Related terms

- [App Integration](https://learn.benibix.com/term/development/app-integration)
- [Data Synchronization](https://learn.benibix.com/term/development/data-synchronization)
- [App Connector](https://learn.benibix.com/term/development/app-connector)
- [JavaScript Object Notation (JSON)](https://learn.benibix.com/term/development/json)
- [Extract, Transform, Load (ETL)](https://learn.benibix.com/term/data/etl)

![Two apps, a shop on the left and a mailing list on the right, each with a connector plug on its side. Between them a small table maps fields: email goes to email_address, and full name goes to first_name and last_name. Below, a one-way sync arrow runs from the shop to the list, and a two-way sync arrow runs in both directions, with a note that two-way sync must decide which change wins.](https://learn.benibix.com/diagrams/dev3-app-sync.svg)

---

Source: https://learn.benibix.com/term/development/field-mapping
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
