> 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-deal-stages-with-hubspot.md).
# How to map deal stages with HubSpot?
When the HubSpot integration is turned on, deals in Kiflo are synced with deals in HubSpot.
Every time a deal moves to a new stage in HubSpot or in Kiflo, the corresponding deal will move to the mapped stage on the other side.
This article describes how deal stages can be mapped.
{% hint style="info" %}
**In this article**
[Choose the target deal pipeline](#choose-the-target-deal-pipeline)
[Choose the sync rule](#choose-the-sync-rule)
[Map deal stages](#map-deal-stages)
{% endhint %}
{% 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 %}
To configure deal stages mapping:
* Go to the **Manage** pas
* Click on **Integrations**
* Click on **HubSpot**
* Click on the tab **Mapping**
* Then select **Deal stages**
## Choose the target deal pipeline
There is only one deal pipeline in Kiflo but you may have many deal pipelines in HubSpot. Kiflo sends deals to only one of your pipelines in HubSpot.
You can select the target pipeline from the list: **Create deals in HubSpot pipeline**
## Choose the sync rule
The sync rule allows you to choose what value Kiflo uses to update deal stages.
Please refer to the [Sync rule section in this article](/integrations/hubspot/how-to-map-fields-with-hubspot.md#sync-rules) to understand the sync rules.
{% hint style="info" %}
**Recommendations**
* If you have more stages in HubSpot than in Kiflo, then select "Prefer HubSpot" and update stages from HubSpot only.
* If partners can also update stages, please select either "Prefer Kiflo" or "Both ways".
{% endhint %}
## Map deal stages
Every deal stage in Kiflo must be mapped to another deal stage in HubSpot. And vice-versa.
If you do not have the same number of stages in Kiflo and HubSpot, you can map the same stage multiple times.
### Edit mapping
On the left column are all the stages in Kiflo. On the right column are all the stages in HubSpot.
Below, the stage *Qualification* in Kiflo is mapped with the stage *Q\&A* in HubSpot:
In the example below, there are more stages in HubSpot. Two additional stages represent the steps after the closing:
* Onboarding ; and
* Upsell
### Common errors
On the mapping page, you may see the following warning:
Or the following errors:
They indicate something is wrong with the mapping and must be corrected. Usually, because some stages have changed in HubSpot or in Kiflo, you need to adjust the mapping accordingly.
---
# 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-deal-stages-with-hubspot.md?ask=&goal=
```
`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.