Async Clipboard read
Asks to read what is on the clipboard.
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
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 76 | 2019-07-30 | read 66 |
| Edge | Supported | 79 | 2020-01-15 | None |
| Firefox | Supported | 127 | 2024-06-11 | readText with Paste menu |
| Safari | Supported | 13.1 | 2020-03-24 | Paste menu |
| Safari on iPhone | Supported | 13.4 | 2020-03-24 | None |
| Chrome on Android | Supported | 76 | 2019-07-30 | None |
| Samsung Internet | Not supported | Not available | Not listed | None |
How a site asks for it
| API | navigator.clipboard.read(), readText(); clipboardchange event |
| Permission name | clipboard-read |
| Permissions policy | clipboard-read |
| Browser compat keys | api.Clipboard.readapi.Clipboard.readText |
| How access is granted | prompt |
| What the user sees | Chromium: 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 gesture | Yes |
| How long it lasts | Chromium: persistent per origin; Firefox and Safari: none |
| How to take it back | Site settings; Permissions API clipboard-read |
| Inside an iframe | Cross-origin iframes need allow="clipboard-read" |
Typical flow
- User gesture (transient activation) or Chromium grant
- navigator.clipboard.readText()
- Prompt or Paste menu appears
- Promise resolves with text or ClipboardItems
Data you get
What comes back: Clipboard text or items
Shape: object
How often: on call
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
text/plain | string | text | any | 1 byte |
text/html | string | html | any | 1 byte |
image/png | binary | bytes | any | pixels |
image/svg+xml | binary | bytes | optional type | bytes |
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
| Type | Example | Apps |
|---|---|---|
| creative | A web design tool lets you paste an image you copied from another app straight onto the canvas. | Figma, Canva, Photopea |
| productivity | A notes or spreadsheet web app pastes a copied table from a doc and keeps the layout. | Google Docs, Notion |
| payments | A payment page reads a copied address or number to fill the form, saving typing errors. | None named |
| developer | A code editor in the browser pastes a snippet with formatting kept. | GitHub Codespaces, VS Code for the Web |
| messaging | A chat web app lets you paste a screenshot from your clipboard to send it right away. | Slack, Discord |
| security | Malicious 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
- web.dev (Google): Async Clipboard API. Google pitches modern clipboard access as a safer, asynchronous way to copy and paste images and text, with a permission prompt.
Good uses and abuse
Legitimate uses
- Paste buttons
- Image paste
Known abuse
- Stealing passwords copied from a manager
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 5 of 5 | How revealing the data is |
| Utility | 4 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
- 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
Related capabilities
Related
- Async Clipboard write. Can put text or images on your clipboard when you tap a button
Sources
How well checked: Checked against real behavior.