Raw JSON data is machine-readable and flexible, but it is useless on a phone. A VCF file is the universal standard for importing contacts into smartphones (iOS/Android), email clients (Outlook, Gmail), and CRMs.
Paste your JSON into the left input box.
You have a JSON array of 50 customer records from your e-commerce store. json to vcf converter
vcf_file.close() print("Conversion complete: output.vcf")
In the modern digital landscape, contact management is the backbone of business communication, marketing, and personal networking. Two file formats dominate this space: JSON (JavaScript Object Notation) for data interchange and VCF (vCard) for contact portability. Raw JSON data is machine-readable and flexible, but
"contact":"personal":"first":"Jane","work":"phone":"555-0001" Flatten the JSON first using a tool like jq (command line): jq 'name: .contact.personal.first, phone: .contact.work.phone' input.json > output.json Then convert the flattened JSON to VCF. Bulk Converting Multiple Files If you have 100 separate JSON files, each with one contact, use a terminal script (macOS/Linux):
| Problem | Likely Cause | Solution | | :--- | :--- | :--- | | | JSON is an object {} not array [] | Wrap your object in square brackets: [...] | | Phone numbers missing | JSON key is "mobile", not "phone" | Edit the JSON to use "phone" OR use a converter that allows custom key mapping. | | Names appear as "Undefined" | JSON key is "fullName", not "name" | Pre-process JSON to rename keys. Use "Find and Replace" in Notepad++. | | Special characters (é, ñ) are garbage | Encoding mismatch | Ensure converter outputs UTF-8. If not, use a script. | | Only first contact imports | Missing END:VCARD or separators | Open VCF in text editor. Ensure each contact block ends with END:VCARD . | Part 8: Advanced Use Cases Converting Nested JSON Many APIs return nested JSON (address inside an object). A basic converter fails. Example: You have a JSON array of 50 customer
This is where a becomes essential. This article explores everything you need to know: why you need it, how it works, the risks of manual conversion, and the best tools to automate the process. Part 1: Understanding the Formats – JSON vs. VCF Before diving into converters, you must understand why direct conversion isn't trivial. What is JSON? JSON is a lightweight data-interchange format. It uses key-value pairs and ordered lists. A typical JSON contact object looks like this: