# Choose the sync and map the fields

> Decide how contacts come in and match HubSpot fields with Bridge

- Type: Task
- App: Admin console
- Screen: CRM
- Section: HubSpot integration
- Also searched as: field mapping, map fields, overwrite, exclude, sync settings, sync, attributes, custom properties, review and sync
- Open: https://help.bridge.new/console/hubspot-mapping?lang=en
- Markdown: https://help.bridge.new/md/console/hubspot-mapping.md

Decide how contacts come in and match HubSpot fields with Bridge

Choose between Overwrite and Exclude, review the mapping Bridge suggests, complete the missing fields and check the result. In 9 steps.

## What you can do

- Overwrite or Exclude
- Mapping suggested by Bridge
- Attributes mapped or created
- The result in Review and sync

## Steps

### Step 1 · Find Sync settings

First you decide how to handle contacts that already exist.

In Connections › CRM, step 1 of the setup, Connect CRM, includes Sync settings. There, before the OAuth authorization, you choose how Bridge should handle contacts that exist in both systems. This setting only affects how data is synced into Bridge: your CRM is not updated unless you sync a contact manually. You can change it after the initial setup.

- Step 1 of the setup: Connect CRM
- Chosen before the OAuth authorization
- Only affects what comes into Bridge

Open: https://help.bridge.new/console/hubspot-mapping/1?lang=en

### Step 2 · Use Overwrite to let CRM data lead

Overwrite gives priority to CRM data.

With Overwrite, contact data in Bridge is automatically replaced with CRM data. Existing information in Bridge is updated to match the CRM.

- CRM data replaces Bridge data
- Existing information is updated

Open: https://help.bridge.new/console/hubspot-mapping/2?lang=en

### Step 3 · Use Exclude to keep Bridge data

Exclude protects contacts already in Bridge.

With Exclude, contacts already in Bridge are not updated with data from the CRM during sync. If needed, you can sync them manually.

- Bridge contacts are not updated
- You can sync them manually

Open: https://help.bridge.new/console/hubspot-mapping/3?lang=en

### Step 4 · Review the suggested mapping

Bridge suggests how the fields match.

Once HubSpot is connected, the setup moves to step 2, Field mapping, titled Connect Bridge attributes with your HubSpot fields. Bridge automatically suggests a mapping based on standard HubSpot property names. Contacts, Deals and other supported objects, including custom objects, are mapped.

- Mapping suggested from standard names
- Contacts, Deals and other objects, custom ones too

Open: https://help.bridge.new/console/hubspot-mapping/4?lang=en

### Step 5 · Check the required fields

Required fields arrive already linked.

Each row shows the HubSpot field (CRM field), its type (Type), the Bridge attribute (Bridge attribute) and the status (Status). Required fields carry an asterisk: First Name, Last Name, Phone Number and Email. Bridge already links them to their attributes, and their status is Linked.

- Required: First Name, Last Name, Phone Number and Email
- Status Linked

Open: https://help.bridge.new/console/hubspot-mapping/5?lang=en

### Step 6 · Map or create the other attributes

Each HubSpot field needs its Bridge attribute.

Fields that do not have an attribute yet, such as Street Address, Annual Revenue, Birth Date, City or Company Name, show Not linked. In the Bridge attribute column, open Map or create... and choose the matching Bridge attribute, or create it if it does not exist yet. You can also map HubSpot custom properties, not just standard ones.

- Not linked: the field has no attribute yet
- Map or create...: choose or create the attribute
- Custom properties too

Open: https://help.bridge.new/console/hubspot-mapping/6?lang=en

### Step 7 · Decide what is shown and what can be edited

You decide which fields are shown and edited in Bridge.

Each field has two toggles: Visible controls whether the field displays in Bridge, and Editable controls whether users can modify it from Bridge. The essential deal fields, Amount, Deal Stage, Close Date and Deal Name, cannot be hidden and are always synced. These toggles are in the Contacts and Deals tabs; the detail is in the guide Control contact and deal fields.

- Visible: the field shows in Bridge
- Editable: it can be changed from Bridge
- Amount, Deal Stage, Close Date and Deal Name, always visible

Open: https://help.bridge.new/console/hubspot-mapping/7?lang=en

### Step 8 · Continue to Review and sync

With the mapping ready, you move to the last step.

When the mapping is ready, click Continue in the bottom bar to move to step 3, Review and sync. Back takes you to the previous step.

- Click Continue
- Back returns to the previous step

Open: https://help.bridge.new/console/hubspot-mapping/8?lang=en

### Step 9 · Review the result of the sync

The last step shows what happened to the contacts.

In Review and sync, Bridge shows the sync summary from HubSpot to Bridge: the HubSpot contacts, the Bridge contacts and the contacts processed during sync, with a donut chart and four groups: Contacts synced, Only in Bridge, Existing in both - overwritten and Partial migration from the CRM to Bridge. To understand each figure, follow the guide Review the HubSpot sync.

- HubSpot and Bridge contacts
- Four groups of processed contacts
- Next guide: review the sync

Open: https://help.bridge.new/console/hubspot-mapping/9?lang=en

## Related guides

- Tour of this screen: [Get to know the HubSpot integration](https://help.bridge.new/md/console/hubspot.md): What the HubSpot integration does and how it works day to day. · Open: https://help.bridge.new/console/hubspot?lang=en
- More in HubSpot integration: [Connect HubSpot from Bridge](https://help.bridge.new/md/console/hubspot-connect.md): Connect your HubSpot portal from the Bridge console · Open: https://help.bridge.new/console/hubspot-connect?lang=en
- More in HubSpot integration: [Install Bridge from the HubSpot Marketplace](https://help.bridge.new/md/console/hubspot-marketplace.md): Install Bridge in your portal from the HubSpot App Marketplace · Open: https://help.bridge.new/console/hubspot-marketplace?lang=en
- More in HubSpot integration: [Review the HubSpot sync](https://help.bridge.new/md/console/hubspot-overview.md): Check in Overview how the sync between HubSpot and Bridge is going · Open: https://help.bridge.new/console/hubspot-overview?lang=en
- More in HubSpot integration: [Choose which activities are sent to HubSpot](https://help.bridge.new/md/console/hubspot-activities.md): Decide which Bridge activity is logged in HubSpot · Open: https://help.bridge.new/console/hubspot-activities?lang=en
- More in HubSpot integration: [Control contact and deal fields](https://help.bridge.new/md/console/hubspot-fields.md): Decide which HubSpot fields are shown and edited in Bridge · Open: https://help.bridge.new/console/hubspot-fields?lang=en
- More in HubSpot integration: [Release conversations by deal stage](https://help.bridge.new/md/console/hubspot-pipelines.md): Release conversations when a HubSpot deal reaches a stage · Open: https://help.bridge.new/console/hubspot-pipelines?lang=en
- More in HubSpot integration: [Handle duplicate contacts with HubSpot](https://help.bridge.new/md/console/hubspot-duplicates.md): Detect and resolve duplicate contacts between HubSpot and Bridge · Open: https://help.bridge.new/console/hubspot-duplicates?lang=en
- More in HubSpot integration: [Disconnect or uninstall HubSpot](https://help.bridge.new/md/console/hubspot-disconnect.md): Stop the HubSpot integration without losing data · Open: https://help.bridge.new/console/hubspot-disconnect?lang=en
- More in HubSpot integration: [Set up webhooks for developers](https://help.bridge.new/md/console/hubspot-webhooks.md): Receive Bridge events in your own service · Open: https://help.bridge.new/console/hubspot-webhooks?lang=en
