How to create or edit CSV files

ProtonMail can import contacts into your ProtonMail account from CSV and VCARD (.vcf) files, and export them as VCARD files.

Spreadsheet programs like Microsoft Excel, Google Sheets, LibreOffice Calc, and Numbers for macOS, make it easy to create and edit CSV files for importing into ProtonMail.

Your CSV file should be formatted as a table and must include a header, or first line, that defines the fields in your table. ProtonMail accepts many common header fields (name, email address, etc.). 

If you’re updating an existing file, you probably won’t need to change your header field names. Alternatively, you can create a new CSV file in any spreadsheet program (such as Microsoft Excel, LibreOffice Calc, Google Sheets, or Apple Numbers).

Once you have entered the header field names and your contact details, simply save the document as a CSV (Comma delimited) (*.csv) file type.

You can also download an example CSV file, which you can tailor to meet your individual needs using the guidance provided below.

Name of field in Proton Contacts Valid header field names
Display name first name, middle name, last name
Email addresses e-mail address, e-mail 2 address, e-mail 3 address, email, alternate email 1, alternate email 2, primary email, secondary email
Phone numbers  tel, other phone, radio phone, home phone, yahoo phone, home phone 2, primary phone, voice, work phone, company main phone, business phone, business phone 2, telephone work, mobile, mobile number, mobile phone, x-mobile, fax, fax number, home fax, business fax, other fax, telex, pager, pager number, car phone
Addresses address 1, address 2, city, state, zipcode, zip, postal code, country, countryregion
Other information (Geo) geolocation, location
Other information  (Organization) company, organization, department
Other information (Birthday) birthday, birth year, birth month, birth day
Other information  (Title) title, job title, jobtitle
Other information  (Member) member, group membership
Other information  (Note) notes, note
Other information (URL) url, web page, personal website, business website, website, web page 1, web page 2, personal web page
Other information  (nickname) nickname, display name, screen name
Other information (Geo) geolocation, location
Other information (Misc) photo, anniversary, role, gender, language, timezone, logo

Adding and importing contacts

Please see our article on Adding and importing contacts for instructions on how to import your CSV file into ProtonMail. Our import wizard now allows you to manually adjust or set the CSV header fields to match the VCard header fields that ProtonMail uses.

Post Comment


  1. Moothayil

    like to be a part of your team . Basically my experience is in Purchasing and I had moved all middle east. Can you include me in your team for marketing this esteem service

  2. ProtonMail Support

    Please send us your CV at

  3. Help


    Please add all the headers needed by the new address book (work email, address, work address, phones numbers etc.). It’s impossible to import contacts from a lots of apps as your system seems to accept headers only in english…

    Thank you,

  4. Terry

    I do not understand . I know nothing about Microsoft Excel . I am a Mac user . Only ever surf the net and use gmail .

  5. Suzette Rall

    I paid for a account with my credit card. Cannot access acct I paid for??

  6. ProtonMail Support

    Please contact our support team using the support form:, at or and they will help you regain access to your account.

  7. Dylan

    Exporting contacts gives me a VCF file instead of a CSV… I need a CSV to import into another service. How can I export a CSV?

  8. ProtonMail Support

    You can only export ProtonMail contacts in vCard (.vcf) format. You can try using a vCard to CSV converter if you need a .csv file.

  9. Michel

    Comment imprimer mails ou brouillons ?

  10. ProtonMail Support

    See: Please note that Drafts cannot be printed.

  11. kyaw Zin Win

    I accident deleted email for job application conversation. The company name is micron. i urgent to contact again. can you help me to recover this email?
    Appreciate your help

  12. ProtonMail Support

    Please check your Trash folder for the message. If you have deleted the message from Trash, it cannot be recovered.

  13. Trent

    A very important feature is to import contacts into a specific group. What is the heading to import contacts into a group?

  14. ProtonMail Support

    Unfortunately, this is not supported with CSV files at the moment. Feel free to add a suggestion to

Comments are closed.