Contact Picker
Lets a person choose contacts to share with a site; Chrome on Android only.
In one line
Can see only the contacts you pick, and only the details it asks for
Lets a person choose contacts to share with a site; Chrome on Android only.
The site gets only the names, emails, phones, addresses or icons of the contacts the person ticks. No bulk read, no desktop, no Firefox, no Safari release.
What it can and can't do
What the user does: You tap Choose contacts, search and select people, and press Done.
It can
- Show a list of your contacts that you can search
- Share the names, emails or phone numbers you pick
- Share only the kinds of details the page asks for, shown before you choose
It cannot
- See contacts you did not pick
- See your full address book
- Work on desktop browsers, where it is not offered
- Keep access after you pick, so it asks again each time
How it differs between platforms: Only Chrome on Android fully supports it. iPhone Safari has it behind a setting. Desktop browsers do not.
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Not supported | Not available | Not listed | Desktop Chrome not supported |
| Edge | Not supported | Not available | Not listed | Not supported |
| Firefox | Not supported | Not available | Not listed | None |
| Safari | Not supported | Not available | Not listed | Not in Safari desktop |
| Safari on iPhone | Behind a flag | 14.5 | Not listed | Preference flag only |
| Chrome on Android | Supported | 80 | 2020-02-04 | None |
| Samsung Internet | Removed | 22 | 2023-07-14 | Exposed in 14, broken, removed in 22 |
How a site asks for it
| API | navigator.contacts.select(['name','email','tel','address','icon'], {multiple:true}); navigator.contacts.getProperties() |
| Browser compat keys | api.ContactsManager |
| How access is granted | picker |
| What the user sees | Native Android contact chooser with search; shows which fields the page asks for |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | Yes |
| How long it lasts | None; each call opens the picker again |
| How to take it back | None needed; nothing persists |
| Inside an iframe | Top level frame only; blocked in cross-origin iframes |
Typical flow
- Call the API
- Browser applies its access rules
- Page receives the result
Data you get
What comes back: Lets a person choose contacts to share with a site; Chrome on Android only.
Shape: object
How often: on demand
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
name | list | None | strings | as stored in the address book |
email | list | None | strings | every address of each picked contact |
tel | list | None | strings | every number |
address | list | None | structured postal address | country, city, postalCode, region, addressLine, recipient, organization, phone |
icon | list | bytes | Blob images | contact photo |
Technical limits
- Only picked contacts, never the whole book
- Chrome Android only; not desktop Chrome or Edge, Firefox, desktop Safari
- Safari iOS behind a developer flag
- Needs HTTPS and a user tap; top level frame only
- getProperties() reports which fields exist, not the data
The story
What it is
A site can ask you to pick contacts to share, on Chrome for Android.
For you
A list of your contacts opens. You tick the people to share and the site gets only those names, emails or numbers.
For makers
Makers can add 'invite friends' and 'send to a contact' without asking for your whole address book. It cuts growth friction and stays safer than bulk access.
Where you see it
| Type | Example | Apps |
|---|---|---|
| social | A web app lets you invite friends by picking them from your contacts. | None named |
| payments | A web payment page lets you pick the person you want to pay. | Cash App, PayPal |
| messaging | A web chat app suggests who to message. | None named |
| games | A browser game lets you pick friends to invite to a match. | None named |
| delivery | A gift site picks the recipient's address from your contacts. | None named |
| security | A scam site could repeat the picker to collect many contacts. | None named |
Risks
- Contact harvesting
- Spam invites
What the platform says
- Google: Contact Picker API. Chrome's docs say the API lets users share chosen contacts with a web app.
Good uses and abuse
Legitimate uses
- Invite friends
- Split bills
- Send money to a contact
Known abuse
- Harvesting contacts via repeated picks
- Spam invites
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 5 of 5 | How revealing the data is |
| Utility | 3 of 5 | How useful it is to honest apps |
| Friction | 2 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2020, Samsung Internet 14: Samsung exposed but contact selector failed; removed in 22
- 2020-02, Chrome on Android 80: Contact Picker ships on Chrome Android only
- 2021-04, Safari 14.5: iOS exposes it only behind a preference flag; never shipped by default
Related capabilities
Related
- Whole address book or call log. Can't see your whole contact list, call history or text messages
Sources
How well checked: Checked against real behavior.