Recently my company moved phones systems to a new VOIP provider. The transition was much smoother than expected on a technical level but we now have all new phone numbers. This posed a challenge to update everyone’s individual vCards. We had all this information in a spreadsheet so I figured I would just download a spreadsheet (or csv file) to vCard converter. After spending way too much time looking, I decided just to build one myself.
CSV to vCard Creator is a simple online tool that will convert a comma delimited file (comma-separated values or CSV) file and into separate vCard (.vcf) files by row.
How it works:
The process the data and converts it into a bunch of vCard files into a directory that is compressed into a zip file for your download. You may encrypt the zip file simply by entering in a password in the web form before uploading the file. All data will be deleted off the server after it is processed except for the zip file. You will have 24 hours to download the zip as many times as you would like before it is deleted.
Instructions on how to use this tool
- Download the sample CSV file for reference: csv_schema.csv
- Open the CSV reference file in Numbers (Mac) or Excel (PC)
- Copy and paste the corresponding columns from your csv file to the sample csv file. ie: copy all the first names from your CSV file into the firstName column of the sample file, and so on. You MUST make your csv file fit the template csv file or the conversion WILL NOT WORK. Leave cells blank if you don’t have the information for the person.
- Export the template file (that now has all your CSV contacts) to CSV format. Numbers (mac) – Go to File in the top bar -> Export -> select CSV option -> next -> choose a name and export.

- Upload the file you just exported into this tool.
>> Click here to open the tool. <<
Further Help:
Upload only a .CSV file (not .xls)
Each row will become a new vCard contact
Make sure to keep the columns the same as the template. The first column (or column A) is the “First Name“ of the contact. The second column (or column B) is the “Last Name“, etc.
You can leave any field (or cell) blank if you don’t have data to add to it
If there is a comma in any field (or cell), put quotes around it like this: “Vice President, Emerging Markets“ or it will process it as two different fields
Dates are formatted in number with a 4 digit year followed by a 2 digit month and 2 digit day.
Thus January 05, 2012 would like this 20120105
For the website or image URL leave off the “http://” and just put in the address like this “dennismueller.org/blog“
For addresses use a semicolon to separate an address. For example:
1 Market St.
San Francisco, CA 94105
United States of America
Should look like this:
1 Market St.;San Francisco;CA;94105;United States of America
April 2, 2010 at 3:28 am
I tried this, but on the result page, could not download file as it says no file found when clicked on the file link.
Hope this is not to try and take peoples contacts. tks
April 5, 2010 at 4:44 pm
I just tried it and it had no issue. Sometimes if you upload your CSV file during the server cleanup process, data gets lost. I recommend just waiting 10 minutes and trying it again.
July 10, 2010 at 10:48 am
The data is deleted once processed and zip are set to be deleted within 24 hours. I clean it up every now and again if for some reason my cron job fails (that does happen).
Also you can also just download this tool and run it locally or someplace more secure than the internet. It is completely open source and free. All you need to do is install in on a system with PHP to run it.
November 6, 2010 at 3:05 am
THANK YOU FOR THIS PROGRAM
December 25, 2010 at 12:58 am
You are welcome!
October 5, 2011 at 2:55 am
When you say “if they choose not to delete them” what exactly does that mean? Do you now have all my contacts in your possession? I assumed your app saved the vcards onto the drive the CSV was on. When I tried looking for them they were no where to be seen. Back at your page I see no “delete all” button. Are you legit? or are you out there to rip off people by using a dot org site?
October 28, 2011 at 12:56 pm
I am legit and have no desire to steal anyone’s contact info. If you are worried, download the source code files yourself and run PHP on your computer. Otherwise you can use a password and it will encrypt the zip file until it is deleted (normally deletion happens within 24 hours).
August 2, 2012 at 7:38 pm
Hi Dennis
I’d really like to use your tool, but I the CSV schema file gives a 404 so I don’t know the expected layout of the CSV file – http://blog.dennismueller.org/2009/03/10/csv-to-vcard-conversion-tool/csv_schema.csv
Also, I coulden’t find the the link to the source code you mentioned in your post from October 28, 2011.
Hope you can help
/Tim
August 2, 2012 at 7:41 pm
Great, I just posted my email as my name – I really shoulden’t stay up till 5am
Would appreciate it if you could change the name for me Dennis, and maybe even delete this response after
August 2, 2012 at 8:00 pm
I will fix the link for you to download the source code. It will take me about 30 minutes though.
October 3, 2012 at 6:48 pm
Help! I am trying to download into roundcube and I followed your instructions by copying your xcel, and it brings up all of the files but when I try to import into roundcube, it says import none.
October 4, 2012 at 5:34 pm
I am not familiar with roundcube. Are you having problems with the vcard imports? If so that is likely an issue with roundcube. If you can’t make the vcards, lets talk.
October 5, 2012 at 8:17 am
The vCards are individual cards, so yes, I think it made them (if they were supposed to be individual) but Roundcube will not import them. It is simply a point, click….(browse, find one vcard at a time, then enter). It won’t enter them.
October 5, 2012 at 4:09 pm
Has it worked with other vcards?
October 5, 2012 at 4:40 pm
Nope, not a one. That’s why I am perplexed. Your site is the only one that boasts being able to make the vcards without me having to purchase and I SO have my fingers crossed…..but it won’t even import one single card.
October 5, 2012 at 5:19 pm
I will email you a couple of vcards over the weekend for you to try. If these don’t load then it is likely a problem with the mail client you are using.
if they do import then I can try to troubleshoot this with you.
October 5, 2012 at 5:32 pm
Thank you kindly!
August 7, 2012 at 6:01 pm
worked great after second try. on my first i was silly and didn’t read the instructions and just uploaded my own csv file.
I looked for a donate button because this success is the result of 2 hours of trying everything else
this is how programs should be. you get full free version and then donate how much you think is appropriate. cod you might pay $50 to find out it doesn’t work.
Great job my friend!
August 8, 2012 at 3:18 am
hi dennis, I’ve tried your tool, its great,..but can you help me for the url images, the image of contact cant appear in vcard
thanks before
August 8, 2012 at 6:28 am
It does only appear as a link with my tool. There is a way to embed an image but I have not been able to get to work. you can read more about embedding images on the wiki page though I fear my tool is not capable of that at this point. Maybe in future revs. Far future revs.
October 8, 2012 at 9:12 am
Okay, your image of Hello Kitty, Orange Skelly imported on mine….is this what you both are talking about?
August 27, 2012 at 9:11 pm
Excellent tools, i m very thank full to that person who put this tools here.
August 27, 2012 at 9:13 pm
You are welcome!
September 20, 2012 at 2:51 am
Hi Dennis,
Where is the link to download the source code?
September 26, 2012 at 5:30 pm
I will update the link again. Sorry. I must of been removed in the mice to WordPress.com hosting.
October 1, 2012 at 6:34 pm
The source code: http://www.dennismueller.org/filedepot/csv2vcf.zip
September 26, 2012 at 5:53 am
thanks a lot
u were of really great help
God Bless You!!
October 1, 2012 at 4:59 pm
I have a CSV file that wont work with this for some reason. Is it possible for me to send it to you via email and have you do it for me?
October 1, 2012 at 6:28 pm
Try downloading this file: http://dennismueller.org/tools/vcard/csv_schema.csv and then make sure not to save it as a different format. If you are still having trouble, let me know what errors you are getting.
October 3, 2012 at 3:09 pm
Mate, you are a legend, just migrated a lot of users and your tool has helped heaps man, thanks.
October 7, 2012 at 6:52 pm
Hello Dennis, I am still hoping you can give me a vcard to attempt to upload. Thank you kindly.
October 8, 2012 at 9:11 am
Okay, I just downloaded your original Dennis card and it uploaded to roundcube successfully.Funny Guy
WorkPlace
VP, Innovation
So I need you to help troubleshoot! YAY! I feel like I am one step closer! Please help!~
October 8, 2012 at 9:17 am
Reading over each vcf and comparing with yours, it would appear each of mine has a space not warranted. Example:
Yours: Dennis_Mueller.vcf
Mine: Alaska .vcf
October 8, 2012 at 9:50 am
Ok so this is good progress actuallu. It probably means that the .csv file you are submitting is not formatted correctly. It may have a space after the first name and that their might be an issue. Also since there is no last name showing up in the vCard file name there could be an issue with the last name of the contact(s). The only two fields that are really required are the first name and last name with no spaces after the name. Try submitting it again with making sure that you have a first name and last name in the .csv file without any spaces after them. Also you can email me the csv file I will take a look at it to make sure there are no issues.
October 8, 2012 at 12:42 pm
I filled in column D to see if that would make a difference with the spacing. Nope. So maybe it is that there is a space added. Now to find where.
October 8, 2012 at 12:56 pm
Is there an email address you can share so I can send you the file OR can you tell me how I can eliminate or even verify there are no spaces in these fields? I have a decent set of cards here and I might go nuts before I figure this all out.
October 8, 2012 at 1:46 pm
Ok so I found your problem. As I said earlier you need to have both a first name and a last name but more importantly, you need to only use the schema in the csv_schema.csv that you can download from above (right click, save as, then edit) You can cut and past the data in the the appropriate columns but you cannot add your own column or rearrange the columns. You can read the “further help” section to get more details.
October 8, 2012 at 1:55 pm
I gave you the first file instead of two, three and four. Did I add columns or rearrange? Let me go check that again….
October 8, 2012 at 2:06 pm
Check your inbox. I specifically cut/pasted into your file all of my columns. It still did not import.
October 8, 2012 at 1:56 pm
Ah, I see what you mean. Let me go try again. Argh!
October 8, 2012 at 7:55 pm
Did you check your email? I simply copy/pasted into each column of YOUR file. It still did not work. Help once again please? Thank you.
October 30, 2012 at 9:22 pm
Thank you helped me a lot
October 30, 2012 at 9:53 pm
You are welcome!
November 11, 2012 at 12:31 pm
YOU ARE AWESOME!!! SAVED MY EVERYTHING ……THANKS MAN
November 11, 2012 at 12:54 pm
Thank YOU for the comment and the praise. I truly appreciate the feedback.
Somethings should be free.
November 27, 2012 at 10:13 am
Great Post Ever ! But these .vcf(s) are not working while i m importing them from import contacts in Nokia PC Suite -it is not giving any error as well – VCF , pc suite imports correctly the vcf files generated by it self. any idea ? thanks in Advance !
December 1, 2012 at 5:05 pm
Sorry for the delay. I have not worked with that software to know what version(s) they accept. If you have a email client like outlook you can try importing them the exporting them again to is if that works. Unfortunately I can’t troubleshoot many of these issues but let me know if you find a solution.
December 4, 2012 at 7:35 am
Hi Dennis – great tool. I prepared a csv file following your instructions and I’m pretty certain I followed the template exactly. However out of 93 records, only 15 emerged when I unzipped the file. Can you think of any explanation for this? I’m happy to send the .csv file over – the records are all public information.
December 4, 2012 at 10:10 am
Yes you can send me the file. I delete everything when I complete the troubleshooting. I am traveling this week so I won’t be able to look at it until this weekend.
December 24, 2012 at 7:15 pm
I have 32MB vcf file. This tool allowing me max 8MB. Pls help.
December 25, 2012 at 8:20 am
I don’t fully understand. Is you CSV file 32 MB and it won’t upload or ate some of your vCards not being produced?
December 25, 2012 at 5:05 am
Dennis… Ur great… Thank u so much.. just followed ur instruction on ur site n all is done in seconds.. was totally frustrated searching for a good software. U rock.. plz give me ur face book id i wanna add u as my friend…
December 26, 2012 at 3:41 pm
Hi Dennis, according to your comments, it looks like this is one of the few conversion programs out there that actually works — except for me! I have a csv file and I can upload it to the browser, supposedly producing a vcard directory. The link to the respective zip appears on the confirmation page, but when I click on it, I am getting a 404 “File Not Found” Error. I can’t tell what the issue is, can you help me out?
Thanks!
Mike
December 27, 2012 at 10:21 am
This tends to be a formatting issue but only one way to find out. Please send me the file and I will try it out. If there is an issue, I will resolve it as best as I can. I will email you directly today and respond to that.
January 3, 2013 at 7:14 am
Hi Dennis, I am facing the same problem.I uploaded the csv file and it says the zip file is created.But click on the .zip file leads to a 404 page not found error.How will I download the zip file?
Neethu
January 3, 2013 at 7:17 am
The last person, Michael, was able to just try again and it worked. Sometime if you do this right as my clean up job is running, it messes with with the process. Try again and if it continues let me know and I will help you. Sorry about the inconvenience.
January 3, 2013 at 7:20 am
The other common issue is that there is an error in formatting with the CSV file. If you are having issues with that I can also take a look but do try to follow my template.
January 12, 2013 at 11:27 am
Hi Dennis. I was able to convert the cvs files into vCards but unfortunately the vCards are not supported on my LG optimus L5 any suggestions? I think there is a problem with the version
January 13, 2013 at 9:00 am
Sorry for the delay. I have not worked with that software to know what version(s) they accept. If you have a email client like outlook you can try importing them the exporting them again to is if that works. Unfortunately I can’t troubleshoot many of these issues but let me know if you find a solution.
January 28, 2013 at 2:27 am
Hi Dennis, i try my best, I use your template, complete it, save as CSV(Macintosh) and upload it to your converter.
if I add a password I can download the .zip file but it’s an empty zip file. And if I don’t put password I have a 404 error page when I try to download it.
February 13, 2013 at 1:42 pm
just uploaded a very big fiel and it just gave back like the first 10
help please
March 8, 2013 at 6:37 am
It is likely am error in the fine or possibly the file is too large. Try breaking it up and/or removing line 11 and try that.
March 27, 2013 at 11:51 am
dear dennis – yours is the only program that has worked for me to convert to v-cards. However, the result is always the poduction of ONE v card. How do I get it to convert the whole (893 entries) list? thanks, jeff
March 27, 2013 at 11:55 am
It normally means that you have a problem with the CSV file. Make sure there are carrot return after each line.
March 27, 2013 at 12:01 pm
actually it only converted the “notes” section, but at least it was importable….
March 27, 2013 at 12:02 pm
carrot return?
March 27, 2013 at 12:13 pm
When i say carrot return i mean a new line in the csv file. Are you using the template for the CSV file that I put up for download? Most people’s issues are that they don’t use that file. This tool concerts about 5000 files a day so my guess is that your problem is with the formatting of the CSV file.
March 29, 2013 at 9:12 pm
sir i have 1369 contacts but when i convert its show only 471 pls help me sir
March 30, 2013 at 11:40 am
Try breaking it up into smaller chunks. My guess is that around line 472 there is an error that the application cannot resolve.
April 2, 2013 at 10:47 am
Okay it converted perfectly and I have a long list of vcards in my “downloads”. I am not comp literate so… I am now stuck. I need to import them into Roundtree but have no idea what the next step is. I realize this is silly to all you comp folks but help would be appreciated it you can see your way to advise in between the laughter.
April 2, 2013 at 11:02 am
What is Roundtree?
April 2, 2013 at 11:12 am
Not Roundtree (that would be a chain of hotels that my text autocorrected to) but rather Roundcube. Sorry for the confusions. I told you I have no idea what I am doing.
April 2, 2013 at 11:37 am
Ok so I am not familiar with roundcube. I looked at their website and it looks like there is a contacts section on their client. My guess is that there is an import option. Otherwise if you can use another email client like outlook, apple mail, etc they all can import vCard files.
April 2, 2013 at 11:40 am
There is an import option but I have to import a file and have no idea how to save the list of vcards in my “downloads” as a single file. I can’t click “save as” and am not comp literate enough to know how to do it.
April 2, 2013 at 11:59 am
Ok. So unzip the file you download from my site. In most computers that is done my double clicking on it. Thine you should see a bunch of vCard files. Copy those to a folder you can easily find like Downloads. Then import each one of those files into roundcube. Round cube might be able to process more than one at a time but I have my doubts.
April 2, 2013 at 12:27 pm
Thank you for all of your assistance. I have successfully created files that contain the vcards but you are correct – roundcube will only import one at a time although it shows that it will import an entire address book file of vcards. *sigh*
April 2, 2013 at 12:29 pm
May 15, 2013 at 5:19 am
Please, i tried to converter a csv archive at your blog, did upload the file, but when tried to download, the page was with 404 error. URL: http://dennismueller.org/tools/vcard.html
May 15, 2013 at 3:37 pm
This normally means that there was an issue with the file you uploaded. I test it regularly and there are about 100 files converted daily so I suspect that your file might have an issue. Please look at the instructions to confirm that you correctly following the format.
May 15, 2013 at 8:18 pm
Oh thank you very much, i’ll see the archive.
March 30, 2013 at 11:41 am
That is weird. I have not seen that unless thee was an error and never processed your CSV file. Please try just using me sample file and see if that works.