Knowledge Base

Topics
Leads
Deals
Contacts: people and organizations
Products
Notes
Activity

Importing: mandatory fields

JT
Jenny Takahara, November 2, 2023

When importing data to Pipedrive from a spreadsheet, it's important to include the fields that are mandatory for each item to be imported successfully. This article takes you through which fields are mandatory for importing.

If you would like more general information on how to import data to Pipedrive, you can read this article.

Note: If you don't import your data with the mandatory fields, no items will be created and a skip file will be generated.

Leads

Every lead in Pipedrive needs to have either a contact person or organization linked to it. To import a lead, you will need the lead title and one of the following in your spreadsheet:

  • Person name
  • Organization name
Screen_Shot_2020-09-30_at_5.17.34_PM.png
Note: If your contact names are in one column (as shown above), use the person name field when mapping your import. If the names are separated by first and last name into separate columns, map the first name and last name fields in Pipedrive.

When mapping your import, you will have to map your spreadsheet columns to the Pipedrive data fields. Once the import is complete, your leads will be automatically linked to your contacts.

Screen_Shot_2020-10-05_at_2.05.23_PM.png

What other fields can I include with my leads import?

You can also import a note or owner along with your leads.


Deals

Similar to leads, every deal in Pipedrive needs to have either a contact person or organization linked to it. To import a deal, you will need to add at least one deal field and any of the following in your spreadsheet:

  • Person name
  • Organization name

We recommend including the deal title field, but it’s not mandatory. If you don’t include a deal title, the deal will automatically take the name of the contact that it is imported with.

Screen_Shot_2020-10-06_at_7.01.56_PM.png
Screen_Shot_2020-10-06_at_7.08.45_PM.png

What other fields can I include with my deals import?

You can also include the following deal fields:

  • Owner
  • Stage
  • Value
  • Expected close date
  • Any custom fields

If you are importing a historic deal or a deal that has already been closed, you can use the following fields:

  • Won time
  • Lost time
  • Status
Note: To import a deal, you don't necessarily need to have a deal title in your spreadsheet. If you want to create deals for each person or organization, you just need to create an empty column in your spreadsheet for the deal titles. Make sure this empty column is mapped to the Deal-Title field.

When imported, the deal's titles will automatically take the name of the organization. If there is no organization, it will take the name of the contact person.


Contacts: people and organizations

When importing people or organizations, only the name is mandatory for successful contact creation. However, it is recommended to add more fields to better identify your contact and avoid duplications from being created. Learn more about how Pipedrive detects duplicates during importing in this article.

For people, add the following to prevent duplicates from being created:

  • email address
  • Phone number

For organizations, include the following to prevent duplicates from being created:

  • Address

Organizations and people can be created separately, but we recommend importing them together to automatically link them.

Screen_Shot_2020-10-05_at_2.53.27_PM.png
Screen_Shot_2020-10-06_at_6.30.30_PM.png
Note: Red in the above images represents a mandatory field.

Products

To import a product, you will just need the product name in your spreadsheet.

Screen_Shot_2020-10-08_at_11.29.57_PM.png
Screen_Shot_2020-10-08_at_11.33.31_PM.png


What other fields can I include with my product import?

You can also include other product fields such as price, currency, description and any custom fields.

Note: Currently it is not possible to link products to deals through an import. You can only link a product to a deal when your data has already been imported into Pipedrive.

Notes

Notes can be added under deals, people, organizations, activities and leads, and cannot exist by themselves. When importing a note, you have to also include information of one of the following (and their mandatory fields):

  • Organization
  • Person
  • Deal
  • Lead
Screen_Shot_2020-10-06_at_8.33.42_PM.png

What are other note fields I can include?

You can add the following fields for notes:

  • Note creation date
  • Note update date

Activity

For the time being, activities don't have any mandatory fields. However, it is recommended to include information such as the subject, due date, type and assigned to user, as well as any linked deals, leads, or contacts.

Screen_Shot_2020-10-06_at_8.47.10_PM.png
Screen_Shot_2020-10-06_at_8.49.16_PM.png

If your activity has already been completed, you can include the following historical fields:

  • Done time
  • Marked as done time
Was this article helpful?

Yes

No

Related articles

Got any questions?

Contact us