vCard Generator screenshot

vCard Generator

Build a vCard 3.0 or 4.0 contact card from labelled fields, with RFC line folding and the four escapes a value needs.

Privacy First
0 Runs
Updated 2026-11-17
Runs in your browser
No sign-up, no upload

What the vCard Generator does

The card is written line by line from the fields above: N holds the family name then the given name, FN the display name, and ORG, TITLE, TEL, EMAIL, URL, ADR and NOTE follow only when you fill them.

Every value is escaped before it is written, and every line is folded at 75 octets, which is the rule both versions state.

The four escapes are \\, \;, \, and a newline written as \n. A name with a semicolon in it needs that escape — Doe; Jr is two fields to a parser otherwise. This page writes one card with one phone, one email and one address; a card with three phones is a hand edit.

How to use it

Fill in the Contact fields: Given name, Family name and anything else you want in the card.

Pick the vCard version — 3.0 for older address books, 4.0 for current ones — and press Run.

The vCard appears below with BEGIN:VCARD and END:VCARD around it. Press Copy, or Download to save a .vcf file your phone can import.

Worked example

Input:


Output:

BEGIN:VCARD
VERSION:3.0
N:Doe;Jane;;;
FN:Jane Doe
ORG:Example\, Inc.
TITLE:Staff Engineer
TEL;TYPE=CELL:+1 555 0100
EMAIL;TYPE=WORK:jane@example.com
URL:https://example.com
ADR;TYPE=WORK:;;1 Main St;Springfield;;12345;USA
END:VCARD

Why it runs in your browser

The result is produced on this page with JavaScript, so it works offline after the page loads and nothing you enter is sent anywhere.

A vCard a phone can actually import: the fields you fill in, written with the escapes and the line folding the format requires.

Both versions are offered because they are not the same document: 3.0 spells the property types in upper case, 4.0 in lower case, and a parser built for one may ignore the other.

What it does, and what it does not

The card is written line by line from the fields above: `N` holds the family name then the given name, `FN` the display name, and `ORG`, `TITLE`, `TEL`, `EMAIL`, `URL`, `ADR` and `NOTE` follow only when you fill them.

Every value is escaped before it is written, and every line is folded at 75 octets, which is the rule both versions state.

The four escapes are `\\`, `\;`, `\,` and a newline written as `\n`. A name with a semicolon in it needs that escape — `Doe; Jr` is two fields to a parser otherwise. This page writes one card with one phone, one email and one address; a card with three phones is a hand edit.

How to use vCard Generator

Fill in the Contact fields: Given name, Family name and anything else you want in the card.

Pick the vCard version — 3.0 for older address books, 4.0 for current ones — and press Run.

The vCard appears below with `BEGIN:VCARD` and `END:VCARD` around it. Press Copy, or Download to save a `.vcf` file your phone can import.

What to Expect

Best for

  • Handing your details to someone in a format a phone imports
  • Checking how a long note folds
  • Building a contact block for a QR code

Not ideal for

  • Syncing an address book, which needs a full card with photos and multiple numbers
  • A card whose fields you cannot see here, such as a second phone

What this tool keeps

  • The version you chose, spelled in the property lines
  • Field order: N, FN, then the optional properties
  • Every escape exactly as the format defines it

What may need cleanup

  • Add the second phone or email by hand
  • Replace the placeholder organisation

Common errors

  • The page refuses it: a vCard needs a given name or a family name

Example use cases

  • Sending contact details in a message
  • Filling a `.vcf` for a phone's import screen
  • A contact QR code's payload

Sample input

Contact fields:

Sample output

vCard: BEGIN:VCARD …

Who this is for

  • Anyone who needs a contact card a phone will import
  • Developers testing a vCard parser

Frequently asked questions

Why is my semicolon escaped?

In a vCard, ; separates the parts of a structured value and , separates list items. A literal one must be written \;, so Doe; Jr stays one family name. The page does that for you.

What does folding at 75 octets mean?

No line may be longer than 75 bytes. A longer value is broken and the continuation starts with one space, which the parser removes. The count is in bytes, not characters, so an accented name folds sooner.

Which version should I pick?

4.0 if the app you are importing into is current; 3.0 if it is old or you do not know. The field order and the escapes are identical — the difference is in property parameters and how strict the parser is.

Developer program

Build custom tools for your store

Join the SDK program to create useful ecommerce utilities for your store.