All Collections
Clients and Contacts
Set up your import files
Set up your import files

To prevent any errors when importing clients into Pixie, learn how to format your import data correctly on your computer before uploading.

Updated over a week ago

Requirements for all import files

  • The import file must be a .csv file.

  • The file must have a header row.

  • During the import process, you can manually map a column to a property of clients and contacts. If the property does not exist yet, you can create it during import.

Import files for each object type require the following properties:

  • Client details: client name.

  • Contacts: client name, first name, last name, and email.

Example import files

Below are examples of what your files should look like:

  • Clients example spreadsheet [download] Ensure you have the client fields created in your Pixie account first. This will allow you to map accordingly. Settings, Client Fields.

  • Contacts example spreadsheet [download]

These example files are not formatted to act as sample import files as they include certain notes on formatting your import file. Open and view them for further advice on formatting your import file.

Requirements for associating contacts with clients in import files

Every contact row in the CSV import file must have must have a column called Client Name. The value of this column tells Pixie which client should be associated with the contact in the row. Clients must already exist in Pixie before contacts can be associated.

For illustration purposes, if you'd like to associate the contact Jane Smith with the client Acme Ltd., the client name value in the contact CSV row must be Acme Ltd.

Other important considerations

Existing Pixie records in the import file

If you import a file with information for existing records, any existing information will be overwritten by new values you've imported. Pixie checks for an existing record using:

  • For clients, the client name is used to check for an existing client.

  • For contacts, the client name and contact email address is used to check for an existing contact.

If you don't want to overwrite an existing value for a property, you can either include the current value in the relevant column or skip that column during import.

If you want to clear a property value in an existing record, you can do so by setting a blank value in the relevant column.

Duplicate records in the same file

If the import file has duplicate records, Pixie will report an error. Please ensure that there are no rows with duplicate client names when importing clients, or client name and email addresses in your import file.

Automatic association between contacts and companies

Contacts will be automatically associated with client records by matching the client name in the contact CSV row to the client name in Pixie.

Unmatched columns in the import file

If your spreadsheet has a column header that does not correspond to an existing property in Pixie, you can create a custom property for it during the mapping step.

Special characters in the import file

Excel does not always properly save special characters when saving in .csv file format. You can try importing your list into Google Sheet and re-export as CSV to resolve this.

Did this answer your question?