Online JSON to vCard Converter
Convert JSON to VCF (vCard) online with our free tool. Enjoy quick and automated JSON to VCF conversions, customizable mapping, and step-by-step guidance.
Map JSON name/phone/email fields into vCard (.vcf) files for Google Contacts, Outlook, and handset import.
Conversion focus
Paste or upload JSON, convert, and save vCard without server-side queues.
Need Custom Conversion?Drop a file here, or click to browse
Max 25 MB. Loads into the same editor as the Text tab; use Convert below.
Map each VCF field to a normalized table column. Use Include to choose output lines; Check all / Uncheck all sit under the mapping table. You can duplicate TEL / EMAIL / ADR to output multiple entries.
| # | VCF Field | Mapping | Include | Others |
|---|---|---|---|---|
| Provide input above to load mapping options. | ||||
Column names and types feed SQL generation (same rules as the CSV tool).
| # | Field Name | Data Type | Max Size | Key | Include | Trim | NULL empty |
|---|---|---|---|---|---|---|---|
| Provide input to load columns. | |||||||
What this conversion is for
Map JSON fields into FN, TEL, EMAIL, ADR, and ORG lines so Google Contacts, Outlook, and handsets receive standards-friendly vCard files.
- Mapping table mirrors live ConversionTab rules—toggle Include per property before export.
- Multiple TEL/EMAIL lines can be duplicated when cards carry several numbers.
- International dialing prefixes improve handset import quality.
Contact mapping: names, phones, emails
- FN (formatted name) anchors each card; ORG and TITLE are optional but common.
- TEL and EMAIL can repeat with types (work, cell) when your JSON lists multiple entries.
- ADR maps structured address lines—use separate columns when the exporter splits components.
- Photos and complex fields may be skipped when targeting lean vCard 3.0 clients.
Use this output next
Dedupe and CRM cleanup in a grid.
Apps and directory sync.
Spreadsheet review of contacts.
Stage contacts for import.
Suggested workflow
Paste JSON in the Text tab or upload a file; use Format when it helps.
Confirm the document parses—objects, arrays, and string quoting must be valid JSON.
Map columns or properties to SUMMARY/DTSTART or FN/TEL—required fields must be non-empty for imports.
Bundle .vcf for Google Contacts, Outlook, or handset import.
Before you convert
- JSON must be valid: duplicate keys, trailing commas, or BOMs break parsers.
- Phone numbers without country codes often import weakly on mobile.
- Keep a copy of the original JSON as the audit trail after you ship vCard.
Choose the right output
When to use vCard
- Phones, Google Contacts, or Outlook require .vcf bundles.
- JSON from a directory API must become importable cards with FN/TEL/EMAIL.
- You are deduplicating contacts before a handset sync.
- Each row represents one person or organization card.
When not to use vCard
- Bulk events belong in ICS, not contact cards.
- Data science paths want CSV/JSON, not vCard folding rules.
- When you only need printable directories, PDF may beat vCard bundles.
- Directory sync (LDAP/SCIM) beats manual vCard drops at enterprise scale.
Why use ConversionTab?
- Runs in your browser — privacy-first; sensitive JSON stays on your device until you copy or download.
- No uploads required — paste or pick a local file; nothing is sent to a conversion backend for the transform itself.
- Fast and secure — lightweight mapping UI with immediate preview for developer workflows.
- Built for everyone — clear steps for non-technical reviewers and power options for engineers.
Continue with other formats
Calendar files for mailbox import instead of VCF.
Typed spreadsheet review instead of VCF.
Executable load scripts instead of VCF.
Flat pipelines and spreadsheet handoffs instead of VCF.
Schema-heavy integrations instead of VCF.
Reviewed JSON → vCard notes
Long-form FAQs live below—expand a section when you need edge cases or field rules.
Step 1: Choose Input Method
Start by selecting your preferred method for inputting JSON data:
- Text Tab: Manually enter your JSON data as a valid string.
- File Tab: Upload your JSON file through the 'Drop/Browse File' feature.
Step 2: Map JSON Attributes
Once your JSON data is entered, proceed to map its attributes to vCard fields. This ensures accurate conversion:
- Email: Select the attribute type (e.g., Email Work) and the corresponding vCard field (e.g., EMAIL).
- Phone: Specify both the attribute type (e.g., Phone Home) and the desired vCard field (e.g., TEL).
- Address: Assign the attribute type (e.g., Address Home) to the appropriate vCard field (e.g., ADR).
Step 3: Control Included Information
Use the 'Include' column to specify which vCard fields should be included or excluded in the resulting VCF file.
Step 4: Handle Multi-valued Fields
If dealing with multi-valued fields (e.g., multiple email addresses), choose one of these methods:
- Combine in a Single Attribute: Separate multiple values using a specified separator (e.g., Email1, Email2).
- Add Rows: Click the '+' button to add rows for each value; use the '-' button to remove unwanted rows.
Step 5: Generate VCF Output
After completing mappings and settings, click the 'Convert' button to initiate the conversion process. You'll then have two options:
- Copy: Copy the generated VCF data for use elsewhere.
- Download: Download the VCF file with the option to specify a custom file name.
The JSON to vCard Converter helps you transform JSON into vCard effortlessly, designed for contact files.
Perfect for vCard compatibility, this tool ensures secure, fast, and precise results for cross-platform sync.
You can either paste your JSON data directly into the input field or upload a file. Select vCard as the desired output format, and the converted file will be ready in moments.
Your converted vCard file is ready to download. Simply save it to your device.
1. How does the JSON to VCF conversion work on ConversionTab?
The JSON to VCF conversion feature on ConversionTab allows users to seamlessly transform JSON data into VCF (vCard) format, commonly used for contact information storage. Users have two input options: 'Text' and 'File.'
2. What are the input options for JSON data?
ConversionTab offers users two convenient ways to input their JSON data:
- Text Tab: Users can manually enter JSON data as a valid string in this tab.
- File Tab: Users can upload their JSON file through the 'Drop/Browse File' feature, making it easy to work with existing data.
3. What happens after entering JSON data?
Upon entering JSON data, users are directed to the 'Output Options' section, where the crucial process of mapping JSON attributes to vCard fields takes place. Accurate mapping is essential for ensuring that the resulting vCard file contains the desired contact information.
4. What are the special requirements for mapping Email, Phone, and Address?
Mapping Email, Phone, and Address attributes involves specific requirements to achieve correct conversions:
- Email: Users must select both the attribute type (e.g., Email Work) and the corresponding vCard field (e.g., EMAIL). This ensures that the email address is correctly categorized.
- Phone: Similar to Email, Phone mapping requires users to specify both the attribute type (e.g., Phone Home) and the desired vCard field (e.g., TEL).
- Address: Address mapping involves assigning the attribute type (e.g., Address Home) to the appropriate vCard field (e.g., ADR).
These specific mappings ensure that contact details are accurately represented in the vCard format.
5. What is the 'Include' column?
The 'Include' column is a crucial part of the conversion process. It provides a checkbox for each vCard field. Users can check or uncheck these checkboxes to control whether specific vCard fields are included or excluded in the resulting vCard file. This gives users full control over which information is included based on their preferences.
6. What are the auto-mapped columns and their formats?
ConversionTab provides the convenience of auto-mapped columns and their corresponding formats:
| # | VCF Field | Mapping | Format |
|---|---|---|---|
| 0 | UID | UID | Unique Identifier |
| 1 | TITLE | Title | Title of Contact |
| 2 | FN | Full Name | Full Name of Contact |
| 3 | TEL | Phone Voice | Voice Phone Number |
| 4 | N | N | Name Components |
| 5 | Email Work | Email Address (Work) | |
| 6 | CATEGORIES | CATEGORIES | Contact Categories |
| 7 | ADR | Address Home | Home Address |
| 8 | URL | URL | Website URL |
| 9 | NOTE | NOTE | Additional Notes |
| 10 | ORG | Organization | Organization Name |
| 11 | BDAY | Birthday | Date of Birth (YYYYMMDD) |
| 12 | GENDER | GENDER | Gender Information |
| 13 | ROLE | ROLE | Contact's Role |
| 14 | IMPP | IMPP | Instant Messaging Protocol |
| 15 | GEO | GEO | Geographical Coordinates |
7. How can I handle multi-valued fields like multiple email addresses?
For multi-valued fields, such as multiple email addresses, ConversionTab provides two methods:
- Combine in a Single Attribute: Users can include multiple values in a single JSON attribute, separating them using a specified separator (e.g., Email1, Email2, Email3).
- Add Rows: Alternatively, users can click the '+' button to add additional rows for each value. The '-' button allows users to remove incorrect mappings or unwanted rows.
This flexibility ensures that multi-valued fields are handled efficiently.
8. How do I get the VCF output?
Once the mapping and settings are complete, users can initiate the conversion process by clicking the 'Convert' button. The resulting VCF data is displayed in a textarea, providing users with two options:
- Copy: Users can copy the generated VCF data for use elsewhere.
- Download: Users can download the VCF file, with the option to specify a custom file name if desired.
This flexibility ensures that users can choose the most suitable method for accessing their converted data.
9. Is there an example JSON and a way to reset the input/output data?
ConversionTab provides additional features to enhance the user experience:
- Example JSON: Users can access a sample JSON by clicking the 'Example' button, which populates the text area with sample data, making it easier to understand the conversion process.
- Reset Functionality: To clear input and output data, users can utilize the 'Clear' button, ensuring a clean slate for new conversions or adjustments.
JSON is parsed as structured input for this page. Use complete rows, valid syntax, and consistent field names so the converter can preserve the important data when creating vCard.
vCard is generated from the parsed JSON data. Review the output before importing it into another system, especially when the destination expects strict columns, dates, or contact fields.
Explore more conversions
Same goal, other inputs
SQL people data compiled into VCF for handset import.
XLSX people data compiled into VCF for handset import.
XML people data compiled into VCF for handset import.
CSV & workbook bridges
Workbook to pipeline text.
Tree to grid for review.
Spreadsheet-first path to the same shape.
Exports & delivery
Web table fragment.
Printable pack from the same source.