clipboard write blocked 🟨 JavaScript

NotAllowedError: Failed to execute 'writeText' on 'Clipboard': Document is not focused.

The Clipboard API refused to write — the page isn’t focused, there was no user gesture, or the context isn’t secure.

Seen on: JavaScript

Meaning

navigator.clipboard requires HTTPS (or localhost), a focused document and usually a user gesture. It’s undefined on plain HTTP.

Common causes

  • Page served over HTTP (navigator.clipboard undefined)
  • Called without a click
  • DevTools focused instead of the page
  • Iframe without clipboard-write permission

⚡ Quick fix

  1. Serve over HTTPS
  2. Call from a click handler
  3. Add allow="clipboard-write" on iframes
  4. Fall back to document.execCommand('copy')

Detailed fix by platform

JavaScript

  1. button.addEventListener('click', () => navigator.clipboard.writeText(text));

How to diagnose

  1. Context — HTTPS?
  2. Gesture — Triggered by a click?

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.