vCard Compatibility Matrix

Current coverage

The launch profiles focus on common vCard 3.0 output, multi-contact files, basic names, phone numbers, email addresses, organisations, notes, and categories. Field support varies by destination.

How to use the matrix

Validate a copy, review warnings, and test a small synthetic import before moving a full address book. A blank cell means the workflow has not been verified, not that the platform cannot support it.

Make the decision before changing data

vCard Compatibility Matrix is easiest to handle when the desired outcome is explicit. Decide whether you are inspecting, transforming, filtering, or importing vCard structure; then choose the vcf validator workspace and keep the source export unchanged. This prevents a compatibility workaround from becoming an irreversible cleanup operation.

For vCard Compatibility Matrix, write down the destination, the expected card count, and the fields that must survive. When checking vCard structure, verify BEGIN/END boundaries, VERSION, line endings, escaping, folding, and unknown properties. If the destination has its own documented version or column names, follow those requirements instead of relying on a generic default.

1. Name the source and destination formats.
2. Save an untouched source copy.
3. Choose the smallest useful transformation.
4. Record the expected count and must-keep fields.

Use a representative test fixture

A successful vCard Compatibility Matrix download is not the same as a successful migration. Before processing a complete address book, use a small copied sample that exercises the risky parts of vCard structure. Include Unicode names, a folded NOTE, escaped commas and semicolons, and a vendor X-property before comparing parser warnings.

While checking vCard Compatibility Matrix, open the preview and raw representation together when available. Look for silent changes such as dropped repeatable fields, reordered name components, altered phone text, removed photos, or values that were ignored because no mapping existed.

1. Start with five to ten representative records.
2. Include one edge case and one ordinary record.
3. Compare the preview with the source.
4. Stop if a change is not explained by the chosen rule.

Verify the output at the destination boundary

After vCard Compatibility Matrix produces a file, validate the output independently before importing or sharing it. Check that the file opens, the card count is plausible, and the key fields remain present. A standards-valid file can still lose information when a destination application supports only a subset of the format.

Keep the vCard Compatibility Matrix output, the source filename, the date, and the choices you made together. That small audit trail makes a second migration reproducible and makes it much easier to identify whether a problem came from parsing, transformation, or the destination application.

1. Run the validator or viewer on the downloaded copy.
2. Compare counts and representative fields.
3. Test the destination with the small sample.
4. Only then process the full address book.