GUIDE

What the UID Field Does in vCard

UID identifies a vCard instance for synchronisation and change tracking. It is not automatically proof that two cards represent the same person.

Last reviewed

DIRECT ANSWER

What you should know

UID identifies a vCard instance for synchronisation and change tracking. It is not automatically proof that two cards represent the same person.

Open the related tool

Before you begin

  • Keep an untouched copy of the source export.
  • Work on a small sample before changing a complete address book.
  • Review the downloaded file before importing it elsewhere.

UID is an identifier, not a display field

A UID can remain stable while names or phone numbers change. It should not be shown as a person's name or merged into a phone number column.

Duplicate detection uses more than UID

Exports from different systems may generate different UIDs for the same person, while shared or copied UIDs can appear on unrelated cards. Combine UID evidence with phones, emails, and human review.

  1. Inspect UID values in a source copy.
  2. Compare duplicates using multiple signals.
  3. Preserve a chosen UID when merging cards.
  4. Validate the output and record the merge decision.

Synchronisation implications

Changing or removing UIDs can make a downstream CardDAV or address-book sync treat a card as new. Only rewrite them when the destination workflow explicitly requires it.

Make the decision before changing data

What the UID Field Does in vCard is easiest to handle when the desired outcome is explicit. Decide whether you are inspecting, transforming, filtering, or importing contact-set changes; then choose the vcf validator workspace and keep the source export unchanged. This prevents a compatibility workaround from becoming an irreversible cleanup operation.

For What the UID Field Does in vCard, write down the destination, the expected card count, and the fields that must survive. When checking contact-set changes, verify record count, identity signals, ordering, and the original backup. 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 What the UID Field Does in vCard 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 contact-set changes. Include two intentional matches, one shared family phone number, and one genuinely different contact with a similar name.

While checking What the UID Field Does in vCard, 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 What the UID Field Does in vCard 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 What the UID Field Does in vCard 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.

Questions people ask

Does What the UID Field Does in vCard change the original file?

No. The browser works with the selected copy and creates a separate download. Keep the original export as your rollback point.

What should I verify after What the UID Field Does in vCard?

Compare counts and representative fields, validate the generated copy, and test a small import before processing a full address book.

References