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

# Field Mapping Workflow

> Map fields from your integrations to Quivly objects

## Overview

Field mapping connects data from your integrated systems (Salesforce, HubSpot, Stripe, etc.) to Quivly objects. Map external fields to core Quivly fields or create custom fields during the process.

***

## Prerequisites

* Integration is connected and has synced data
* You have Admin access

***

## Configuring Field Mappings

<Steps>
  <Step title="Navigate to Object Settings">
    Go to **Settings** → **Objects** → Select the object you want to configure (e.g., Customers)
  </Step>

  <Step title="Select Integration">
    In the **Configuration** tab, select which integration to map from the dropdown.

    <Note>
      Once you save a mapping, the integration is locked and can only be changed by support.
    </Note>
  </Step>

  <Step title="View Available Fields">
    The left panel shows all fields available from the external system. Use the search box to filter fields. Hover over fields to see sample values.
  </Step>

  <Step title="Map Fields">
    For each external field you want to sync:

    1. Click the field
    2. Select a Quivly field from the dropdown, or click **Create New Field** to add a custom field
    3. The mapping is staged — an "Unsaved changes" badge appears until you click **Save Mappings**
  </Step>

  <Step title="Create Custom Fields (Optional)">
    When creating a new field:

    * Enter a field label
    * Select the field type (string, number, boolean, date, email, url, json, or reference)
    * For reference fields, select which object it links to
  </Step>

  <Step title="Save Configuration">
    Click **Save** to activate your mappings. Changes apply on the next sync.
  </Step>
</Steps>

***

## Field Types

| Type          | Use for                       |
| ------------- | ----------------------------- |
| **String**    | Text values                   |
| **Number**    | Numeric values                |
| **Boolean**   | True/false values             |
| **Date**      | Dates and timestamps          |
| **Email**     | Email addresses               |
| **URL**       | Web links                     |
| **JSON**      | Complex nested data           |
| **Reference** | Links to other Quivly objects |

***

## Auto-Computed Fields

Some fields are automatically computed by Quivly and cannot be manually mapped. These appear in a separate "Auto-computed Fields" section with a lock icon.

***

## Notes

* Each external field can only be mapped to one Quivly field
* Core field mappings are locked after first save
* Use the **Raw Data Preview** section to see sample data from the external system