Skip to Content
Platform.Ontology

Contact Picker

Lets a person choose contacts to share with a site; Chrome on Android only.

You pick what to shareContacts and personal dataContactsWeb browsersWhile you use it

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

BrowserStatusFirst versionReleasedNote
ChromeNot supportedNot availableNot listedDesktop Chrome not supported
EdgeNot supportedNot availableNot listedNot supported
FirefoxNot supportedNot availableNot listedNone
SafariNot supportedNot availableNot listedNot in Safari desktop
Safari on iPhoneBehind a flag14.5Not listedPreference flag only
Chrome on AndroidSupported802020-02-04None
Samsung InternetRemoved222023-07-14Exposed in 14, broken, removed in 22

How a site asks for it

APInavigator.contacts.select(['name','email','tel','address','icon'], {multiple:true}); navigator.contacts.getProperties()
Browser compat keysapi.ContactsManager
How access is grantedpicker
What the user seesNative Android contact chooser with search; shows which fields the page asks for
Needs a secure context (HTTPS)Yes
Needs a user gestureYes
How long it lastsNone; each call opens the picker again
How to take it backNone needed; nothing persists
Inside an iframeTop level frame only; blocked in cross-origin iframes

Typical flow

  1. Call the API
  2. Browser applies its access rules
  3. 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

FieldTypeUnitRangePrecision
namelistNonestringsas stored in the address book
emaillistNonestringsevery address of each picked contact
tellistNonestringsevery number
addresslistNonestructured postal addresscountry, city, postalCode, region, addressLine, recipient, organization, phone
iconlistbytesBlob imagescontact 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

TypeExampleApps
socialA web app lets you invite friends by picking them from your contacts.None named
paymentsA web payment page lets you pick the person you want to pay.Cash App, PayPal
messagingA web chat app suggests who to message.None named
gamesA browser game lets you pick friends to invite to a match.None named
deliveryA gift site picks the recipient's address from your contacts.None named
securityA scam site could repeat the picker to collect many contacts.None named

Risks

  • Contact harvesting
  • Spam invites

What the platform says

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

ScoreValueMeaning
Sensitivity5 of 5How revealing the data is
Utility3 of 5How useful it is to honest apps
Friction2 of 5How much the user has to do
Fingerprint bitsNot ratedRough 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

Sources

How well checked: Checked against real behavior.

On this page