Field Mapping

Field Mapping

TL;DR: Field mapping determines how data translates between  monday.com  columns and HubSpot properties. Map the right columns, set the direction for each field, and the sync handles the rest.

Before you start

  • Field mapping is part of the sync wizard — you'll reach it after choosing your HubSpot object type, sync direction, and items/subitems. See  Setting up a Sync⁠ 
  • Make sure your board has the right columns — see  Board Setup Best Practices⁠ 

How field mapping works

During sync setup, you match each  monday.com  column to a HubSpot property. When a mapped field changes on one side, the other side updates automatically based on the sync direction.
The mapping screen shows one row per board column. The app pre-fills suggested mappings, so review them and change any you need. Click Refresh properties to reload the list of HubSpot properties.
Missing a column on your board? Click + Add column to create one right from the mapping screen.

Column type compatibility

Not every  monday.com  column type works with every HubSpot property type. Here's a reference:
monday.com Column Type
Compatible HubSpot Property Types
Text
Single-line text, Multi-line text, Phone number
Long Text
Multi-line text, Rich text
Numbers
Number, Currency
Status
Dropdown select, Radio select, Checkbox
Date
Date picker, Date & time
Email
Email
Phone
Phone number
Link
URL

Per-field sync direction

Fields sync both ways by default. Select the arrow on a row to change the direction for that field:
  • Monday → HubSpot only — changes in  monday.com  update HubSpot
  • HubSpot → Monday only — changes in HubSpot update  monday.com 
  • Both ways (default) — changes on either side update the other
Some HubSpot properties are read-only (e.g., Record ID, Create Date). These can only sync from HubSpot to monday — the direction selector will be locked.

Map status values

For a Status column, click the Map values icon on its row. In the dialog, match each  monday.com  status label to a HubSpot option. The dialog shows how many labels are mapped (for example, 0/3 mapped).

Common mapping scenarios

Example: Deals

HubSpot Property
monday.com Column
Deal Name
Item Name
Deal Stage
Status: "Deal Stage"
Amount
Numbers: "Amount"
Close Date
Date: "Close Date"
Deal Owner
People: "Owner"

Common gotchas

  • Create columns before mapping, or add them from the mapping screen with + Add column
  • Match column types — a Status column maps well to a HubSpot dropdown; a Numbers column maps to numeric properties. Mismatched types won't appear as options
  • Map only what you need — each mapped field that changes counts as 1 action. Mapping unused fields wastes quota
  • The sync only triggers when a mapped field changes — if you update a column that isn't mapped, nothing happens
  • You can change field mappings after activation. Open the HubSpot 2-way Sync view on your board and click the edit (pencil) icon to open Edit Sync Configuration. New mappings apply to future syncs only, not retroactively
  • Custom HubSpot properties are fully supported — they appear in the mapping dropdown alongside default properties
  • If you don't see a HubSpot property in the dropdown, check that your connected HubSpot user has permission to access it

Next up

Related

  •  Setting up a Sync⁠  — full setup walkthrough
  •  Board Setup Best Practices⁠  — recommended columns and structure
  •  Understanding Conditional Triggering⁠  — filter which records and items sync
  •  The HubSpot Link column⁠  — the column that links items to records
  •  Plans, Billing & Usage⁠  — how actions are counted

Still stuck?

If something isn't working as expected, check  Troubleshooting⁠  or  FAQ⁠ . You can also reach us at  hello@fantasymedia.io .