Skip to Content
Platform.Ontology

EyeDropper

Lets the person pick a colour from anywhere on screen.

You pick what to shareHardware and accessoriesDisplay hardwareWeb browsersWhile you use it

In one line

Can pick one color from anywhere on your screen when you click

Lets the person pick a colour from anywhere on screen.

Returns one pixel colour the person points at, including outside the page. Cannot capture other pixels.

What it can and can't do

What the user does: You tap Pick color and click a spot on the screen.

It can

  • Show a magnifier so you can choose a color
  • Get the color code of the one spot you click
  • Work on any part of the screen, even outside the page

It cannot

  • Take a screenshot or see anything but the color you click
  • Pick without you clicking; Esc cancels it
  • Keep picking after you click once
  • Work in Firefox, Safari, or on phones

How it differs between platforms: Only desktop Chrome and Edge support it. Firefox, Safari and phone browsers do not.

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported952021-10-19Before Chrome 120, the EyeDropper API is not available on ChromeOS. See <a href="https://crbug.com/40720753"&gt;bug 40720753</a>. Available on Linux X11, but not a
EdgeSupported952021-10-21Before Edge 120, the EyeDropper API is not available on ChromeOS. See <a href="https://crbug.com/40720753"&gt;bug 40720753</a>. Available on Linux X11, but not ava
FirefoxNot supportedNot availableNot listedNone
SafariNot supportedNot availableNot listedNone
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidNot supportedNot availableNot listedNone
Samsung InternetNot supportedNot availableNot listedNone

How a site asks for it

APInew EyeDropper().open() resolves {sRGBHex}
Browser compat keysapi.EyeDropper
How access is grantedpicker
What the user seesMagnifier cursor over the screen; Esc cancels
Needs a secure context (HTTPS)Yes
Needs a user gestureYes
How long it lastsPer origin
How to take it backSite settings
Inside an iframeSame as top level; cross-origin iframes need a permissions policy where listed

Typical flow

  1. Call the API
  2. Browser applies its access rules
  3. Page receives the result

Data you get

What comes back: Lets the person pick a colour from anywhere on screen.
Shape: object
How often: on demand

FieldTypeUnitRangePrecision
sRGBHexstringNone#000000 to #ffffff24 bit colour

Technical limits

  • One pixel per call
  • Needs gesture
  • Desktop Chrome and Edge only

The story

What it is

A site can let you pick a colour from anywhere on your screen.

For you

You click a pipette tool and your cursor turns into a magnifier. You click and the page learns only that one colour.

For makers

Makers can add a colour picker to design tools without extra apps. The page gets one value at a time and only after you click, so it cannot read your screen.

Where you see it

TypeExampleApps
creativeA web design tool lets you grab a colour from a photo on another window.Figma, Canva
productivityA slide tool matches a chart colour to your logo.Google Slides
developerA developer tool copies a colour from any site into code.Chrome DevTools
shoppingA makeup site lets you match a shade from a picture.None named
educationA drawing lesson lets kids sample colours from art.None named
gamesA browser pixel art maker picks colours from a reference image.Pixilart

Risks

  • Low risk
  • Chrome only

What the platform says

Good uses and abuse

Legitimate uses

  • Design tools
  • Colour pickers

Known abuse

  • None; one pixel only

Scores

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility2 of 5How useful it is to honest apps
Friction1 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2021-09, Chrome 95: EyeDropper ships

Sources

How well checked: Checked against real behavior.

On this page