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

# Remapping simple fields

> Learn how to use the remapping feature to adjust simple Kombo default fields based on fields in your customer's systems.

## Remapping a simple string/number/boolean field

To start the remapping process open the remapping UI and click on the `Override default Kombo value` button of the field you want to remapp.

<Frame><img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/remapping/override-buttons.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=ee0042336bbf1126a57d15328c2b7d29" alt="image" width="1432" height="1764" data-path="images/remapping/override-buttons.png" /></Frame>A new popup will
appear allowing you to configure the remapping for the individual field.

<Frame>
  <img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/remapping/simple-modal.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=20847a979bde2cc92b94e20f12df1181" alt="image" width="960" height="628" data-path="images/remapping/simple-modal.png" />
</Frame>

Under `Priority 1` you can select the source field you would like to use for the
remapping. You can search in the selection box, see the example values and even
use our custom field explorer feature.

<Frame>
  <img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/remapping/simple-modal-extended.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=619ba1562f8ad28baae727d1282c4d78" alt="image" width="1124" height="868" data-path="images/remapping/simple-modal-extended.png" />
</Frame>

After selecting the field, you can press the `Save` button to save the
configuration.

<Frame>
  <img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/remapping/simple-modal-save.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=98b52cc6f110cfb7370763f6cbc9cdc6" alt="image" width="966" height="630" data-path="images/remapping/simple-modal-save.png" />
</Frame>

If this is your first remapping, a popup will appear, which reminds you that **a
sync is required** for the saved changes to show their effect.

<Frame>
  <img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/remapping/run-sync-reminder.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=cd594c914bae124e5fa1e469d35f4af0" alt="image" width="822" height="436" data-path="images/remapping/run-sync-reminder.png" />
</Frame>

## Fallbacks

In case the selected field is removed (`undefined`), `null` or changes it's structure (`string` => `array`), the remapping will result in `null` as output.
For these cases it makes sense to define one or multiple fallback values, when configuring a remapping. You can do so by clicking the `Add fallback` button in the configuration UI.

<Frame>
  <img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/remapping/fallback-button.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=45164c342fcbb79a0604a50f4fc13410" alt="image" width="962" height="628" data-path="images/remapping/fallback-button.png" />
</Frame>

We will execute the remapping top to bottom. This means the remapping stops for
each the entity (employee, candidate, job...) has soon as valid value is found.

<Frame>
  <img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/remapping/fallback-configured.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=ecce4c9d1f6f17a679fe839408c4daa3" alt="image" width="964" height="950" data-path="images/remapping/fallback-configured.png" />
</Frame>

You can also use the **Fallback to Kombo's mapping** button to include Kombo's standard mapping logic as one of the priorities in your fallback chain. This is useful when your custom field is not always populated and you want to fall back to what Kombo would have mapped by default. Learn more in the [Kombo Default Fallback](./kombo-default-fallback) guide.
