> ## 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.

# Introduction

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

## Prerequisits

The remapping UI is located on each individual integration right next to the "Custom Field Mappings" tab.

<Frame>
  <img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/remapping/tab-location.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=6f61edca292540dc8a76fa56d533d92d" alt="image" width="2398" height="1142" data-path="images/remapping/tab-location.png" />
</Frame>

1. Your scope config for the integration will need either `custom_fields` or `integration_fields` **enabled for each model** you wish to remapp.
   <Frame>
     <img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/remapping/scope-config.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=7a9c0d77c5a68f5845c52431f937af84" alt="image" width="1552" height="1440" data-path="images/remapping/scope-config.png" />
   </Frame>
2. The initial sync has **finished successfully** and the integration is **not in QA mode**.
   <Frame>
     <img src="https://mintcdn.com/kombo/DniMaFamDeZQwfSo/images/remapping/sync-pending.png?fit=max&auto=format&n=DniMaFamDeZQwfSo&q=85&s=a64ef69b53be5032b3308a351a4d092a" alt="image" width="1066" height="136" data-path="images/remapping/sync-pending.png" />
   </Frame>
3. (optional) To improve your mapping experience we recommend enabling custom field examples for new integrations. The setting can be found under `Configuration` in the left sidebar.
   <Frame>
     <img src="https://mintcdn.com/kombo/gOJSp7BFh1-OoJE6/images/remapping/custom-field-examples.png?fit=max&auto=format&n=gOJSp7BFh1-OoJE6&q=85&s=bf0430c9c8c6ab7b2adc98434b36cc9d" alt="image" width="1860" height="1254" data-path="images/remapping/custom-field-examples.png" />
   </Frame>

We offer different user interfaces to accomedate the complexity that comes with each specific field:

1. [Simple string/number/boolean fields](./simple-remapping)
2. [Enum fields](./enum-remapping)
3. [Date fields](./date-remapping)
4. [Address fields](./struct-remapping)
5. [Reference fields](./reference-remapping)
6. [Array fields](./array-remapping)

Additionally, you can use the [Kombo Default Fallback](./kombo-default-fallback) to include Kombo's standard mapping logic as a priority in your fallback chain — available for simple, enum, and date fields.
