> For the complete documentation index, see [llms.txt](https://docs-vnext.kiflo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-vnext.kiflo.com/integrations/hubspot/how-to-map-fields-with-hubspot.md).

# How to map fields with HubSpot?

{% hint style="warning" %}
**Looking to map deal stages instead?**

Check out this page: [How to map deal stages with HubSpot?](/integrations/hubspot/how-to-map-deal-stages-with-hubspot.md)
{% endhint %}

The native HubSpot integration can be configured to choose for each field *if* and *how* it must be synchronized. This provides the high degree of flexibility required to keep your CRM clean.

This page describes how to customize the field mapping between Kiflo and HubSpot.

{% hint style="info" %}
**Before you begin**

* Make sure the HubSpot integration is enabled: [HubSpot](/integrations/hubspot/hubspot.md)
* And you turned on the right settings to sync deals: [Settings](/integrations/hubspot/hubspot.md#turn-on-settings)
  {% endhint %}

Customize the mapping:

* Go to the **Manage** page
* Click on the **Integrations** button
* Click on **HubSpot**
* Click on the **Mapping** tab
* Then select the type of object you'd like to map

![](https://3041514930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkJn82Qo5a0Y4fOsoQzo%2Fuploads%2Fgit-blob-8f1a74785e66efd04f3e152034919d33815a12ae%2F64fee93b26847651a7f5494a.png?alt=media)

## Add mapping

In order to sync a new field with HubSpot:

* Click the **Add mapping** button
* Select the source property from Kiflo
* Select the target property in HubSpot
* Choose the sync rule that describes how the field should be synced
* Then click the **Add** button to save changes

[Learn more about sync rules](#sync-rules)

## Remove mapping

If you'd like to stop syncing a field, you can remove the mapping:

* Check or more rows (mapping)
* Click the **Delete** button
* Then confirm the deletion

Those fields won't be synced anymore. It does not impact/remove the data already sent to Kiflo or HubSpot.

## Compatible types

You can only select compatible properties. Text properties can be mapped with text properties, date properties with date properties, and so on.

Here are the compatible property types:

| Kiflo property type | HubSpot property type |
| ------------------- | --------------------- |
| Single-line text    | Single-line text      |
| URL                 | Single-line text      |
| Email               | Single-line text      |
| Multi-line text     | Multi-line text       |
| Checkbox            | Single checkbox       |
| Multi-select        | Multiple checkboxes   |
| Single select       | Dropdown select       |
| Date                | Date picker           |
| Number              | Number                |
| Currency            | Number                |
| Kiflo user          | Hubspot user          |

## Mapping list of values

For *Single select* or *Multi-select* properties, every single option must be mapped. A new section is visible when adding a mapping on single or multi-select properties:

![](https://3041514930-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKkJn82Qo5a0Y4fOsoQzo%2Fuploads%2Fgit-blob-f299323b85663553e3255ace596a69b273d625fc%2F64fef197b7432c05c604dfa7.png?alt=media)

The left column represents all possible values in Kiflo and the right column represents all possible values in HubSpot.

## Sync rules <a href="#sync-rules" id="sync-rules"></a>

For each mapping specify how the data must be synced. There are four different options:

| Sync rule               | Description                                                                                                                                                                                 |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Prefer Kiflo**        | The most recent value from Kiflo will always overwrite the value in HubSpot. If the field is emptied in Kiflo it won't empty the field in HubSpot.                                          |
| **Prefer HubSpot**      | The most recent value from HubSpot will always overwrite the value in Kiflo. If the field is emptied in HubSpot it won't empty the field in Kiflo.                                          |
| **Both ways (default)** | The fields are synced both ways. The most recent value always overrides the previous one. If it's changed in HubSpot it will update Kiflo, if it's changed in Kiflo it will update HubSpot. |
| **None**                | The fields won't be synced at all. It's equivalent to removing the mapping.                                                                                                                 |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs-vnext.kiflo.com/integrations/hubspot/how-to-map-fields-with-hubspot.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
