Skip to content

Generate an example import file

Last updated: August 30, 2024

Available with any of the following subscriptions, except where noted:

All products and plans

To help ensure you're importing the required data, you can generate and download an import file template based on the objects you've selected during the import process. Example files include only the properties required to create new records, but you can add more columns as needed to import additional data. For example, if you've selected to import contacts, companies, calls, and meetings, your custom example file will contain all of the required columns for each object.

Learn more about setting up your import files, including how to format property values in each column. To review example files with additional columns and sample data, view other sample files.

To download an example file:

  • Click Import in the top right of any object index page.
  • On the Imports page, click Start an import.
  • Select Import file from computer, then click Next.
  • Select the objects and activities you want to import, then click Next.
  • Click Download example file. If you're importing objects in two files, you can download an example file for each object.

download-example-import-file

  • In the downloaded file:
    • Columns are created for each object's required properties. In some cases, you may only need to import one of the required properties (e.g., include Email or First name or Last name to create contacts), which will be explained in the file notes.
    • Each column will have <[OBJECT] [property internal name]> to indicate the object to which the property should map (e.g., <COMPANY domain> for the company property Company domain name). This shouldn't be removed as it'll automatically map your columns during the import process.
    • There are rows containing information to help you import data correctly. For example, your file may have instructions explaining you only need one of the required properties to create a record. You must delete these rows prior to import.

Please note: to avoid duplicates or import multiple objects and associate their records, ensure you've included unique identifier values. Learn more about deduplication and association requirements for importing.


downloaded-example-import-file
  • Add values for the required properties and add other columns as needed.
  • Upload the file and complete the import.

Learn more about importing records and activities.

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.