The contact import block is part of Airtable Blocks, a Pro plan feature. Blocks let you extend the functionality of your bases: you can use blocks to bring new information into Airtable, visualize and summarize your records in colorful ways, and even directly integrate your Airtable bases with your favorite apps.
The contact import block allows you to add contact information to an existing table by importing vCard (VCF) files.
Watch this video to learn more about how to set up and use a contact import block, or read on for further information.
After adding a contact import block to your base, you can drag and drop a vCard file onto the block.
After the file gets uploaded, you'll be brought to a screen where you can map exactly how the information from the vCard file gets added to your table. Before mapping the fields, make sure you have the correct table selected.
The left side of the Field mappings section (with the toggles) shows the values from the vCard file, and the right side (with the dropdowns) shows the fields in your table. To map a value, select a toggle associated with a vCard value, then choose a field from the dropdown menu. Repeat this process for as many fields as you want.
Note that you don't have to import any values you don't need to, and the names of the values in your vCard file don't necessarily have to match the names of the fields in your Airtable base. As you alter the field mappings, you can look at the right side of the block, which shows samples of the records that will be created according to the specified mappings.
Once you're ready, click the Create records button.
The block will remember your field mappings the next time you import another vCard file.
In addition to creating new records with the contact import block, you can also use the contact import block to update existing records. To do this, you'll need to pick a field on which to merge records (ideally containing a unique value like a name or an email address, for example). The block will then compare the records in your table with the entries in your vCard file, find matches using the field you selected, and update the values in the table according to the contents of the vCard file.
To get started, drag and drop a vCard file onto the block, and click the Merge with existing records toggle. You will then be prompted to pick a field: the block will use whichever field you pick to compare your existing records with the values in the vCard file.
Matching for the field you select will be case-sensitive; for example, the block will consider "firstname.lastname@example.org" and "SampleEmail@example.com" to be two different values. (However, leading and trailing whitespace will be ignored when finding matches.)
Once you pick a field, the block will display previews for the records to be updated. If the vCard being imported contains entries which have no matches in the table, the block will create new records. The bottom of the block window will show the number of records that will be updated, the number of records that won't change, and the number of new records that will be created (if any).
A few other notes on the updating process:
- If the vCard file contains multiple entries which contain the same value for the merge field, the block will only use the first of those rows, and subsequent rows will be ignored.
- If the table has multiple records, all of which contain the same value for the merge field, all of those records will be updated if there's a matching entry in the vCard file.
- If the vCard contains any entries where the value in the merge field is blank, a new record will be created.
If everything looks good, click the Save button.