Support — ContactFixer

How do I install ContactFixer?

ContactFixer is installed via Xcode directly to your iPhone. Open the .xcodeproj file, connect your device, set your Apple ID as the signing team, and press Run. A free Apple ID is all you need — no paid developer account required for personal use.

Why does the app ask for Contacts permission?

ContactFixer needs read and write access to your contacts in order to find phone numbers missing the +1 country code and update them. This is a standard iOS permission — the same one the built-in Contacts app uses.

If you accidentally denied permission, go to Settings → Privacy & Security → Contacts and enable ContactFixer.

What iOS version is required?

ContactFixer requires iOS 16 or later.

Which phone numbers does ContactFixer change?

ContactFixer only updates US phone numbers that are missing the +1 country code. Specifically, it acts on:

• 10-digit numbers like (708) 555-0142 or 3125550198 — these become +1XXXXXXXXXX

• 11-digit numbers starting with 1 like 17085550031 — these become +17085550031

Any number already starting with + is left completely untouched, regardless of country.

Will it affect my international contacts?

No. Any number already beginning with + is skipped entirely. A UK number stored as +44 7911 123456 will not be modified.

Note that Canada, the Bahamas, and many Caribbean nations also use the +1 country code (the North American Numbering Plan). 10-digit numbers from those countries will also receive the +1 prefix — which is correct for them.

What about contacts with only a company name?

ContactFixer fully supports company-only contacts. If a contact has no first or last name, the company/organization name is displayed instead.

Can I undo the changes after applying?

ContactFixer doesn't include a built-in undo feature, but you can protect yourself before running it:

On a Mac, open Contacts.app, press ⌘A to select all contacts, then go to File → Export → Export vCard… and save the .vcf file somewhere safe. If you ever need to restore, simply drag that file back into Contacts.app.

If you use iCloud Contacts, your contacts are also continuously synced to iCloud.com, which provides an additional safety net.

Does ContactFixer send my contacts anywhere?

No. ContactFixer makes no network requests whatsoever. All processing happens entirely on your device using Apple's native Contacts framework. Your data never leaves your iPhone.

You can verify this by running the app in airplane mode — it works identically.

Does ContactFixer collect any data or analytics?

No. There are no analytics, crash reporters, or tracking of any kind. See the full Privacy Policy for details.

The app shows 0 contacts to update — is something wrong?

Not at all — it means all your US phone numbers already have the +1 country code. Nothing needs to be changed.

The app won't install on my iPhone.

A few things to check:

• Make sure your Apple ID is set as the signing team in Signing & Capabilities

• Set a unique Bundle Identifier, e.g. com.yourname.ContactFixer

• Go to Settings → General → VPN & Device Management on your iPhone and trust your developer certificate after the first install

• Ensure your iPhone is running iOS 16 or later

I see Xcode build warnings about Swift concurrency.

Make sure you're using the latest version of the ContactFixer source from the GitHub repository. Earlier versions had concurrency warnings that have since been resolved by rewriting the contact store access using a dedicated Swift actor.