Import contacts from CSV. Map columns to contact fields. Export contacts to CSV for backup and migration.

Import and Export Contacts

Use CSV import to add many contacts at once, and CSV export to back up or migrate your contact list. Both operations work with standard comma-separated values (.csv) files.

Importing Contacts

Supported Format

CrystalQore supports CSV (Comma-Separated Values) for import. Your file should:

Use commas to separate values
Have a header row with column names
Encode special characters correctly (UTF-8 is typical)

Before creating your import file, you can download a sample CSV directly from the import dialog. The sample file shows the expected column format and includes example data — use it as a starting template.

Open the Import dialog
Click Download sample CSV
Open the file, fill in your contacts, and save

Import Steps

Open Import — In the Contacts module, click the Import button (often in the header or under a menu).

Upload your CSV file — Select the file from your device. The import wizard loads it and detects columns.

Map columns to contact fields — CrystalQore auto-detects common column names (e.g., "first_name" maps to First Name, "phone" maps to Phone). Review the suggested mapping and adjust any columns that weren't matched correctly.

Preview results — The wizard shows:

Category	Description
Valid	Rows that will be imported successfully
Invalid	Rows with errors (missing required fields, bad format) with specific reasons
Duplicates	Rows matching existing contacts (skipped automatically)

Review the counts and invalid row details before proceeding.

Confirm and import — Click Import to add the valid contacts to your directory.

Field Mapping

During import, you map CSV columns to these contact fields (where available):

CrystalQore Field	Common CSV Column Names
First Name	first_name, firstName, First Name
Last Name	last_name, lastName, Last Name
Email	email, Email, E-mail
Phone (Work)	phone, work_phone, Phone
Phone (Mobile)	mobile, cell, Mobile
Company	company, Company, Organization
Title	title, Title, Job Title
Address	address, Address
City	city, City
State	state, State, Province
Zip Code	zipCode, zip, Zip Code, Postal Code
Country	country, Country
Tag	tag, Tag, Category
Notes	notes, Notes, Description

Column names in your CSV may differ. The mapping step lets you assign each column to the correct field. Unmapped columns are ignored.

Handling Duplicates

The import process detects duplicate contacts (e.g., same email or phone number already exists in your directory). Duplicates are automatically skipped — only new contacts are imported. The preview step shows exactly how many duplicates were found so you can verify before proceeding.

Exporting Contacts

Export Steps

Open Export — In the Contacts module, open the Export option.
Select scope — Choose which contacts to export (e.g., My Contacts, Shared with Me, or a filtered list).
Download CSV — Start the export. A CSV file downloads to your device.

Export Contents

The CSV includes the contact fields you have in CrystalQore:

Name, email, phone numbers
Company, title, department
Address
Notes
Other configured fields

You can open the CSV in Excel, Google Sheets, or any spreadsheet or CRM that supports CSV.

Page	Description
Managing Contacts	Create and edit contacts manually
Sharing Contacts	Share contacts with teammates
Contacts Overview	Contact views and features

Import and Export Contacts

Import and Export Contacts

Importing Contacts

Supported Format

Download Sample CSV

Import Steps

Field Mapping

Handling Duplicates

Exporting Contacts

Export Steps

Export Contents

Use Cases

Migration

Backup

Bulk Updates

On this page