Knowledge Base
  • Chào mừng bạn tới trang hỗ trợ sản phẩm của chúng tôi !
  • Page Site Builder
    • Bắt đầu tạo một trang web
      • Thêm một section
        • Sao chép section
        • Cài đặt section
        • Di chuyển section
      • Thêm một page
      • Thêm kết nối SSL
  • HubSpot CRM
    • crm-setup
      • Get started with objects
    • contacts
      • Create contacts
      • A guide to your contacts home
      • Work with your contact records
      • HubSpot's default contact properties
      • Property field types in HubSpot
      • Set up your import files
      • Import data to checkbox properties
      • Manage your properties
      • Import contacts, companies, deals, tickets, products, or notes
      • View and analyze previous imports
      • Troubleshoot import errors
      • Deduplicate contacts, companies, deals, tickets, and products
    • companies
      • Create companies
      • A guide to your companies home
      • Work with your company records
      • HubSpot's default company properties
    • deals
      • Create deals
      • A guide to your deals home
      • Work with your deal records
      • HubSpot's default deal properties
    • tickets
      • Create tickets
      • Work with your ticket records
      • A guide to your tickets home
      • HubSpot's default ticket properties
  • Google Ads
    • Topic
      • Setup and basics
      • Measure results
      • Manage ads
      • Smart campaigns
      • Billing
      • Learn
      • Google Partners
      • Your guide to Google Ads
      • Google Ads basics
      • Create ads and campaigns
      • Choose where and when ads appear
      • Find out if your ad is running
      • Account administration and security
      • Glossary
      • Local Services ads
      • The Google Ads mobile app
      • Ads and approvals
      • Campaign settings
      • Budgets and bids
      • Keywords
      • Reach your audience
      • Target placements and topics
      • Multiple or large accounts
      • Connect your goals to data
      • Find and run reports
    • Google Ads Help
  • Google Analytics
    • answer
      • Get started with Analytics
      • Find your way around Analytics
      • Guided tours
      • Manage and configure Analytics
      • Hierarchy of organizations, accounts, users, properties, and views
      • Diagnostics messages
      • How to get support
      • Google Marketing Platform Partners
      • Introducing Google Marketing Platform
      • Organizations
      • Google Analytics Home
      • Search in Google Analytics
    • Topic
      • Set up (web)
      • Set up (mobile apps)
      • Universal Analytics (UA)
      • Glossary
      • Troubleshoot Analytics problems
      • Understand the Analytics account structure
      • Accounts
      • Properties
      • Reporting views
      • Reporting-view filters
      • User management
      • Common issues
      • Monitor account health and performance
      • Audience reports
  • Google Tag Manager
    • answer
      • Tag Manager overview
      • Considerations before you install
      • Setup and install Tag Manager
      • Tag Manager and gtag.js
      • Introducing Google Marketing Platform
      • The data layer
      • Components of Google Tag Manager
      • Supported tags
      • Conversion linker
      • Google Optimize
      • Custom tags
      • AMP & Tag Manager setup guide
      • Content experiments for mobile apps
      • Custom templates
      • Community Template Gallery
      • Google Marketing Platform Partners
      • Data Processing Amendment
    • Topic
      • Tags
      • Triggers
      • Variables
      • Google Analytics
      • Google Ads
      • Floodlight
      • Accounts
      • Workflow
      • Organization
      • Troubleshooting
Powered by GitBook
On this page
  • Before you get started
  • Import one file with one object type
  • Import one file with multiple object types
  • Import two files for association

Was this helpful?

  1. HubSpot CRM
  2. contacts

Import contacts, companies, deals, tickets, products, or notes

PreviousManage your propertiesNextView and analyze previous imports

Last updated 5 years ago

Was this helpful?

Import files to create or update contacts, companies, deals, tickets, or products in HubSpot. You can also import and associate notes to objects.

Please note: in order to comply with Google's OAuth app requirements, the ability to import contacts directly from Gmail was removed on May 1, 2019. You can use to import contacts from Gmail into HubSpot.

You can import objects to HubSpot in the following ways:

Please note: to import notes and associate them to an object's record, either with multiple object types or . You cannot import a single file with only notes as they have to be associated to a new or existing object.

Before you get started

Before you start an import, to confirm you have all the required fields for your import type.

Import one file with one object type

Follow these steps when your file contains only one object type (e.g., the file contains only contacts).

  • Ensure that your import file is already .

  • In your HubSpot account, .

  • In the upper right, click Import.

  • Click Start an import.

  • Select File from computer, then click Next.

  • Select One file, then click Next.

  • Select One object, then click Next.

  • Select the object type in your import file.

  • Click choose a file and in the dialog box, select your import file. Select the checkbox if you're . In the bottom right, click Next.

  • On the Map columns in your file to contact properties screen, HubSpot will match the columns in your file to your selected object type's properties based on the header and the property name. You'll see a preview of the property values from your spreadsheet in the Preview Information column.

  • If any columns do not match an existing property, click the corresponding dropdown menu. You can do opt to do one of the following:

    • Select an existing property to map the column to.

    • Select Don't import column to skip importing this column from your spreadsheet.

  • If you're not intending to import any data in the unmatched columns, you can select the Don't import data in unmatched columns checkbox to skip these columns.

  • Once all columns are mapped or you've opted not to import data in the unmatched columns, click Next.

  • On the details screen, enter an Import name.

    • If you're importing a file with only contacts, select the Create a list of contacts from this import checkbox to automatically create a list when the contacts are imported.

    • If you're importing a file with a date property, use the Date format dropdown menu to confirm how the date values in your spreadsheet are formatted.

  • Once you've set the options for your import, click Finish import in the bottom right.

Import one file with multiple object types

Follow these steps when your single file contains more than one type of object (e.g., the file contains contacts, deals and notes). Currently, you cannot import products through this method.

  • In the upper right, click Import.

  • Click Start an import.

  • Select File from computer, then in the bottom right, click Next.

  • Select One file, and click Next.

  • Select Multiple objects, and click Next.

  • Select the types of objects in your import file. Then, click Next.

  • Click Next.

  • On the Map columns in your file to contact properties screen, HubSpot will automatically match the columns in your file to properties in your selected objects. You'll see a preview of the property values from your spreadsheet in the Preview Information column.

  • If any columns do not match an existing property, click the corresponding dropdown menu:

    • If you don't want to import this column, select Don't import column.

    • If you don't want to import any columns without a matching property, select the Don't import data in unmatched columns checkbox.

  • After you've mapped all of the columns from your file, click Next.

  • On the details screen, enter an Import name.

    • If you're importing a file with a date property, use the Date format dropdown menu to confirm how the date values in your spreadsheet are formatted.

  • Once you've set the options for your import, click Finish import in the bottom right.

Import two files for association

Follow these steps when you have your data in two different files and would like to associate the objects between the files.

Please note: products currently cannot be associated through imports.

  • Click Import.

  • Click Start an import.

  • Select File from computer, then click Next.

  • Select Multiple objects with associations, then click Next.

  • Select the two objects or an object and notes to associate via import, then click Next.

  • Click Next.

  • Specify the common column you're using in the files to associate your data:

    • To specify the column header for the common field in both of your spreadsheets, click the Common column headers found in your files dropdown menu.

    • The common column is the unique key that associates objects, but only belongs to one object. To specify which object has a unique value for the common column, click the Which object is [header] the unique key for? dropdown menu and select the object. This matters when there are many-to-one associations (e.g., many deals associated to one contact).

  • Click Next.

  • Click Next.

  • On the Map columns in your file to contact properties screen, HubSpot will automatically match the columns in your file to the selected objects' properties in HubSpot. You'll see a preview of the property values from your spreadsheet in the Preview Information column.

    • If any columns do not match an existing property, click the corresponding dropdown menu:

      • If you want to map the column to an existing property, select an existing property.

      • If you want to exclude a column from your spreadsheet from importing, select Don't import column.

      • If you want to skip any columns without a match, select the Don't import data in unmatched columns checkbox to skip any columns without a match.

    • Click Next, then map the columns in the second spreadsheet.

    • Once you've mapped the columns in both of your files to properties in HubSpot, click Next.

  • On the Details screen, enter an import name.

  • Click Finish import.

Click Create a new property to set up a in the right panel. The data in the column will now be mapped to this new custom property.

If you've in your account, use the Set the legal basis for processing a contact's data dropdown menu to select a .

You can .

Ensure that your import file is already .

In your HubSpot account, .

Click choose a file, then select your import file. If you're , select the Update existing records using “Object ID” exported from HubSpot checkbox.

If you want this column to map to an existing property, select which object's properties you need to match, then select a property.

If you want to match the column to a , select the object then click Create a new property. In the right panel, set up your custom property.

Please note: when importing a note, there are two fields you must include in the import file: . The values for these fields are not stored in a property, but they are included in the note engagement on the record's timeline.

If you've in your account and your import includes contact records, use the Set the legal basis for processing a contact's data dropdown menu to select a .

You can .

Ensure that your import files are , and you've included a column with the same header in both files for association.

In your HubSpot account, . If you want to import and associate notes, navigate to the object you’ll be adding notes to.

For each object type, click choose a file, then select your import file. If you're either or both of your files, select the corresponding Update existing [object] using "[Object] ID" exported from HubSpot checkbox.

relational-import-upload-your-files
relational-import-map

If you want to set up a , click Create a new property.

Please note: if you're importing contacts or companies the Email or Company domain name property will not be mapped. It is not required that you import the column you've used as the unique identifier for your records.

If you've in your account and you're importing contacts, use the Set the legal basis for processing a contact's data dropdown menu to select a .

You can .

new custom property
turned on
General Data Protection Regulation (GDPR) functionality
lawful basis of processing
view, analyze, and create lists with your previous imports
set up correctly
navigate to your contacts, companies, deals, or tickets
using the object ID to deduplicate your contact, company, deal, or ticket records
new custom property
activity date and note body
turned on
General Data Protection Regulation (GDPR) functionality
lawful basis of processing
view, analyze, and create lists with your previous imports
set up correctly
navigate to contacts, companies, deals, or tickets
using object ID to deduplicate
new custom property
with the object ID
turned on
General Data Protection Regulation (GDPR) functionality
lawful basis of processing
view, analyze, and create lists with your previous imports
PieSync
import notes in a single file
associate notes to an object by importing two files
learn how to set up your import file
set up correctly
navigate to your contacts, companies, deals, tickets, or products
using the object ID to deduplicate your contacts, companies, deals, tickets, or products
Import one file with one object type.
Import one file with multiple object types.
Import two files with one object type each, and associate the objects between each file.
select-object-type-to-match
New call-to-action