HubSpot import unmapped / unrecognized columns

An unmapped or unrecognized column means the CSV header did not clearly match a HubSpot contact property in the destination account or import profile. HubSpot may ask you to map it manually, create a custom property, or skip the column.

ReadyCSV can review headers locally against its HubSpot Contacts preset, but it does not connect to HubSpot or create account-specific properties for you.

Mapping problems usually come from source-system labels, account-specific custom fields, or columns that are useful internally but do not have a direct HubSpot property. A friendly spreadsheet header can still require a decision in HubSpot's import mapping screen.

• Unknown headers may not map to any built-in HubSpot contact property.
• Recognized aliases may still need review when multiple source columns point at the same destination field.
• Full Name often needs human splitting into First Name and Last Name.
• Custom account properties cannot be confirmed locally without a HubSpot connection.

1. Decide which columns must import and which columns can be skipped.
2. Rename obvious aliases to the HubSpot property names you want before export.
3. Split Full Name into First Name and Last Name when the destination import expects separate fields.
4. Create or confirm custom HubSpot properties before mapping account-specific columns.
5. Review HubSpot's import mapping screen carefully before committing the import.

ReadyCSV flags unknown headers as unmapped_column info findings. Those columns are kept in the export, but the finding tells you they may not import correctly unless you map or review them in HubSpot.

ReadyCSV also emits hubspot_manual_mapping_review warnings for columns that may require manual mapping or property creation. For Full Name, ReadyCSV can emit a mapping_suggestion info finding that says the column can be split into First Name and Last Name.

The import profile can list recognized header aliases and local rename actions, but ReadyCSV does not map the columns into HubSpot itself. Use the HubSpot CSV formatting checklist with the CSV column format guide before upload.