XML to vCard

Online XML to vCard Converter

Convert XML to VCF (vCard) online with our free tool. Quick, automated conversions with customizable mapping and step-by-step guidance.

The conversion workspace is built for private XML handling, with processing completed in your browser.

Conversion focus

Schema-aware handling helps keep columns and nested fields understandable.

Need Custom Conversion?
XML file

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.
Include column:

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

Flatten XML into columns, map headers to vCard fields using the on-page mapping table, then export .vcf for contacts apps.

  • Conversion options for XML include Flatten nested structures, flatten type, and (when flattening is off) Select table—same behavior as JSON tabular exports.
  • First extracted row as header, Limit # of rows, and Skip # of rows shape the intermediate grid feeding vCard.
  • Use Format after edits to ensure the parser still accepts your file before a long export.

Understanding your XML structure

  • The tool parses your file into an element tree; deep nesting stays nested until you enable Flatten nested structures with Type 1 / 2 / 3.
  • With flattening off, repeated sibling elements can surface as separate “tables” in Select table—choose the one that matches the rows you need.
  • Malformed XML (unclosed tags, bad entities) fails fast in the browser parser—fix the source, then use Format or Convert again.
  • For targets that build a table first, Limit # of rows and Skip # of rows under Conversion options help you rehearse on a subset.

vCard export from XML-derived columns

  • XML is parsed to rows first; each row can become one vCard after you map headers to properties.
  • Use the mapping accordion to align columns with FN, TEL, EMAIL, ADR, and related fields—controls match the live ConversionTab mapping UI.
  • Include toggles and duplicate-line actions follow the same rules as other tabular → VCF paths.
  • Invalid or empty required mappings surface as export issues—fix the grid before retrying.

Suggested workflow

Paste XML in the Text tab or upload a file; use Format when it helps.

Check root element, namespaces, and that entities are well-formed before mapping.

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

  • Large XML can be memory-heavy—start with a slice if the file is huge.
  • Phone numbers without country codes often import weakly on mobile.
  • Keep a copy of the original XML as the audit trail after you ship vCard.

Choose the right output

When XML to vCard is useful

  • Contacts apps require vCard text, not arbitrary XML.
  • You can map extracted column headers to vCard properties in the mapping accordion.
  • You need FN/TEL/EMAIL-style bundles Google or Outlook can import.
  • Each logical row becomes one card after mapping.

When another format is better

  • 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 — XML you paste or load stays on your device while you Format or Convert.
  • No mandatory upload — the transform runs client-side; you copy or download results from your own session.
  • Fast iteration — quick feedback when markup or options change.
  • Structured handoffs — suited to engineers and reviewers moving data between systems without extra glue services.

Reviewed XML → vCard notes

FAQ accordions below complement this page—open a section when you need edge cases or field rules.

The XML to vCard Converter helps you transform XML 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 XML 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.

Step 1: Enter Text or Upload File

Start by providing your XML data. You can either type it in or upload an XML file. Ensure that the input adheres to the required XML format for accurate conversion.

Step 2: Click the "Convert" Button

Once your XML data is entered and options are selected, click the "Convert" button. This triggers the system to process the XML information and convert it into VCF (vCard) format while maintaining the structure and integrity of the data.

Step 3: Copy Result Data or Download VCF File

After the conversion is complete, you have options. Copy the result to use immediately, or click "Download" to save the VCF file on your device. This enables easy access and sharing of the converted data whenever needed.

Converted VCF Output:

BEGIN:VCARD VERSION:3.0 FN:Aimee EMAIL:Mckenna_Toy24@yahoo.com TEL:262-665-9227 x945 ADR:698 Rohan Pine URL:https://ethical-developmental.com TITLE:Mechanical Engineer ORG:Hegmann - Lueilwitz BDAY:20100928 END:VCARD BEGIN:VCARD VERSION:3.0 FN:Laverne EMAIL:Eloy46@gmail.com ADR:417 Lillian Locks TEL:520-581-7516 x007 URL:https://outlying-lamb.org/ TITLE:Software Engineer ORG:Conn - Leuschke BDAY:19950429 END:VCARD

XML 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 XML data. Review the output before importing it into another system, especially when the destination expects strict columns, dates, or contact fields.

1. How does the XML to VCF conversion work on ConversionTab?

The XML to VCF conversion feature on ConversionTab allows users to seamlessly transform XML 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 XML data?

ConversionTab offers users two convenient ways to input their XML data:

  • Text Tab: Users can manually enter XML data as a valid string in this tab.
  • File Tab: Users can upload their XML file through the 'Drop/Browse File' feature, making it easy to work with existing data.

3. What happens after entering XML data?

Upon entering XML data, users are directed to the 'Output Options' section, where the crucial process of mapping XML 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).

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 FieldMappingFormat
0UIDUIDUnique Identifier
1TITLETitleTitle of Contact
2FNFull NameFull Name of Contact
3TELPhone VoiceVoice Phone Number
4NNName Components
5EMAILEmail WorkEmail Address (Work)
6CATEGORIESCATEGORIESContact Categories
7ADRAddress HomeHome Address
8URLURLWebsite URL
9NOTENOTEAdditional Notes
10ORGOrganizationOrganization Name
11BDAYBirthdayDate of Birth (YYYYMMDD)
12GENDERGENDERGender Information
13ROLEROLEContact's Role
14IMPPIMPPInstant Messaging Protocol
15GEOGEOGeographical Coordinates
This auto-mapping simplifies the conversion process by recognizing and configuring common attributes automatically.

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 XML 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.

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 XML and a way to reset the input/output data?

ConversionTab provides additional features to enhance the user experience:

  • Example XML: Users can access a sample XML 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.