โ† Back to Help Center

Import contacts from a vCard (.vcf) file

vCard is the standard contact-export format every phone, Mac, and Google account already speaks. Drop a .vcf file into RadiusOS and your phone's address book becomes your starting pipeline.

What vCard is

vCard (file extension `.vcf`) is the universal contact-export format. Every iPhone, Android, Mac, and Google Contacts account can produce one in two taps - that's why RadiusOS uses it as the import bridge from your phone to your CRM. A .vcf file is just plain text describing one or more contacts: name, email, phone, address, notes. Open one in a text editor and you'll see lines like `BEGIN:VCARD` and `FN:Sarah Chen`.

If you've never exported a .vcf file before, that's fine - the steps below are short. If you already have one (someone shared an address book with you, or you exported from Google Contacts), skip ahead to "Where to import in RadiusOS."

Where to import in RadiusOS

There are two entry points - both go to the same import screen.

1

Sign in to RadiusOS

If you don't have an account yet, sign up at radiusos.ai - the import is free on every plan, no credit card required.

2

Open Contacts

From the left sidebar, click Contacts. (Some templates label this differently - Customers, Clients, Leads, Applications. Same thing - it's the page that lists everyone in your pipeline.)

3

Click the Import button in the top-right

On the Contacts page header, you'll see three buttons: Export, Import (this one), and Import CSV. The plain Import button is for vCard / phone imports. Click it.

4

Drop your .vcf file

On desktop you can drag-and-drop the file onto the page, or click "Pick a .vcf file". On mobile, tap "Pick a .vcf file" and use the file picker. Max file size is 5 MB - that's plenty for thousands of contacts.

5

Review and confirm

RadiusOS shows a preview table of every contact in the file. Duplicates against your existing pipeline are flagged and unchecked by default. Uncheck anyone you don't want to import, then click "Import N contacts".

6

You're done

Imported contacts appear immediately in your contact list and the first stage of your pipeline. Click "View contacts" to start working.

๐Ÿ’ก

Empty workspace? RadiusOS shows the import button as a callout banner above your contact list when you haven't added any real contacts yet. Hard to miss.

Exporting a .vcf file from your phone

How to grab your contacts off your phone, by platform. Pick yours.

1

iPhone (one contact)

Open the Contacts app โ†’ tap the contact โ†’ scroll to the bottom โ†’ tap Share Contact โ†’ choose Mail (send to yourself) or Files (save to iCloud Drive). The shared file is a .vcf.

2

iPhone (many contacts)

Open Contacts โ†’ tap Lists in the top-left โ†’ long-press the list you want โ†’ tap Export. iOS produces one .vcf with every contact in the list. Send it to yourself via Mail or save it to Files.

3

Android

Open the Contacts app โ†’ tap the menu (โ‰ก or three dots) โ†’ Settings (or "Manage contacts") โ†’ Export โ†’ choose "Export to .vcf file". Save to your phone's storage or share to email.

4

Mac (Contacts app)

Open Contacts โ†’ select the contacts you want (Cmd+A for all) โ†’ File โ†’ Export โ†’ Export vCard. Save the .vcf file. Drag it into RadiusOS.

5

Google Contacts (web)

Go to contacts.google.com โ†’ click Export in the left sidebar โ†’ choose "vCard (for iOS Contacts)" โ†’ Export. The .vcf file downloads automatically.

6

Outlook / Microsoft 365

Outlook on the web doesn't export vCard directly. Use People โ†’ Manage โ†’ Export contacts to get a CSV instead, then use "Import CSV" in RadiusOS.

What gets imported

FieldImported?Notes
NameYesPulled from FN (formatted name) or composed from first + last.
EmailYesFirst email in the card wins if there are several.
PhoneYesCell preferred, then work, then home. Stored as digits-only.
CompanyYesStored on the contact's notes for now. Manual link-to-company is one click.
Job TitleYesStored on the contact's notes.
Address (street, city, state, postal code, country)YesHome address preferred over work.
NotesYesTruncated to 500 characters.
PhotoNoPhotos in vCards are usually low-resolution and bloat file size.
Custom fields (X-* properties)NoCarrier-specific extras like X-iCloud aren't imported.
Group membershipsNoTag your contacts inside RadiusOS after import.

How duplicates are handled

โ„น๏ธ

If a contact in your file matches an existing RadiusOS contact by phone or email, it's skipped. Your existing data is never overwritten.

Phone numbers are compared as digits-only - so `(415) 555-0100`, `415-555-0100`, and `+14155550100` all match each other. Emails are compared case-insensitively. The preview screen flags every duplicate so you can see the count before you click Import.

Privacy

โ„น๏ธ

Your .vcf file is parsed and discarded. We never store the original file.

Parsing happens on RadiusOS servers, not in your browser, so the file is uploaded once and held in memory only long enough to extract contacts. No copy is kept on disk and no copy is sent to third parties.

Plan tier

PlanvCard import
Free ($0)Yes - unlimited
Pro ($19/mo)Yes - unlimited
Business ($39/mo)Yes - unlimited
Team ($69/mo)Yes - unlimited

vCard import is free on every plan because the empty-workspace problem is the single hardest thing about adopting a new contact tool. CSV import is a paid feature; vCard is not. The two formats are different - CSV is for bulk spreadsheet exports, vCard is for the contacts already on your phone.

Built a workflow that works? Share it.

Publish your pipeline template to the RadiusOS marketplace. Free to install, free to publish - help someone in your trade skip the setup.