Skip to Content
Platform.Ontology

Async Clipboard read

Asks to read what is on the clipboard.

Asks you firstTyping and clipboardClipboardWeb browsersWhile you use it

In one line

Can see what you last copied, after you allow it or tap Paste

Asks to read what is on the clipboard.

Can show anything the person copied: passwords, addresses, personal messages. Chromium asks permission; Firefox and Safari show a one-time Paste menu so the person approves each read.

What it can and can't do

What the user does: You tap Paste on the page, or allow clipboard access when the browser asks

It can

  • See text, images or other items you copied, one request at a time
  • Fill a form from what you copied
  • Show items you copied in any app, not just on this page

It cannot

  • Peek at your clipboard in the background while you are in another tab or app
  • Get your clipboard in Chrome or Edge when the page is not in focus
  • Skip the small Paste button in Firefox and Safari; you tap it each time
  • Change your clipboard; that is a separate permission

How it differs between platforms: Chrome and Edge ask once for permission. Firefox and Safari show a small Paste button you tap every time.

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported762019-07-30read 66
EdgeSupported792020-01-15None
FirefoxSupported1272024-06-11readText with Paste menu
SafariSupported13.12020-03-24Paste menu
Safari on iPhoneSupported13.42020-03-24None
Chrome on AndroidSupported762019-07-30None
Samsung InternetNot supportedNot availableNot listedNone

How a site asks for it

APInavigator.clipboard.read(), readText(); clipboardchange event
Permission nameclipboard-read
Permissions policyclipboard-read
Browser compat keysapi.Clipboard.read
api.Clipboard.readText
How access is grantedprompt
What the user seesChromium: permission prompt when document is focused. Firefox 125+ and Safari: floating Paste menu available after 1 second, skipped for same-origin content.
Needs a secure context (HTTPS)Yes
Needs a user gestureYes
How long it lastsChromium: persistent per origin; Firefox and Safari: none
How to take it backSite settings; Permissions API clipboard-read
Inside an iframeCross-origin iframes need allow="clipboard-read"

Typical flow

  1. User gesture (transient activation) or Chromium grant
  2. navigator.clipboard.readText()
  3. Prompt or Paste menu appears
  4. Promise resolves with text or ClipboardItems

Data you get

What comes back: Clipboard text or items
Shape: object
How often: on call

FieldTypeUnitRangePrecision
text/plainstringtextany1 byte
text/htmlstringhtmlany1 byte
image/pngbinarybytesanypixels
image/svg+xmlbinarybytesoptional typebytes

Technical limits

  • Needs focus and gesture
  • Not in workers
  • Firefox and Safari do not support the clipboard-read permission name

The story

What it is

A site asks to read what you last copied.

For you

A prompt asks if the site may see text and images you copied. Safari and Firefox show a small Paste button instead. If you say no, the page cannot see your clipboard.

For makers

Makers use it for paste buttons in editors and image tools, so users do not have to press keyboard shortcuts. It also powers paste from phone to desktop style features.

Where you see it

TypeExampleApps
creativeA web design tool lets you paste an image you copied from another app straight onto the canvas.Figma, Canva, Photopea
productivityA notes or spreadsheet web app pastes a copied table from a doc and keeps the layout.Google Docs, Notion
paymentsA payment page reads a copied address or number to fill the form, saving typing errors.None named
developerA code editor in the browser pastes a snippet with formatting kept.GitHub Codespaces, VS Code for the Web
messagingA chat web app lets you paste a screenshot from your clipboard to send it right away.Slack, Discord
securityMalicious pages can try to read a copied password or crypto address if a person says yes.None named

Risks

  • Could see passwords or private text
  • Prompt could be rushed

What the platform says

Good uses and abuse

Legitimate uses

  • Paste buttons
  • Image paste

Known abuse

  • Stealing passwords copied from a manager

Scores

ScoreValueMeaning
Sensitivity5 of 5How revealing the data is
Utility4 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

  • 2018-12, Chrome 66: clipboard-read permission ships
  • 2020-03, Safari 13.1: Async clipboard API baseline
  • 2024-04, Firefox 125: Async read via Paste menu

Sources

How well checked: Checked against real behavior.

On this page