US/docs/Web/API/Idle_Detection_API "Idle Detection API") to detect when users
are interacting with their devices, for example to report "available"/"away"
status in chat applications.

Specifically, where a defined policy blocks use of this feature, [ `
IdleDetector.start() ` ](/en-US/docs/Web/API/IdleDetector/start) calls will
return a [ ` Promise ` ](/en-
US/docs/Web/JavaScript/Reference/Global_Objects/Promise) that rejects with a [
` DOMException ` ](/en-US/docs/Web/API/DOMException) of type ` NotAllowedError
` .

##  Syntax

http

    
    
    Permissions-Policy: idle-detection=<allowlist>;
    

` <allowlist> `

    

A list of origins for which permission is granted to use the feature. See [ `
Permissions-Policy ` > Syntax ](/en-US/docs/Web/HTTP/Headers/Permissions-
Policy#syntax) for more details.

##  Default policy

The default allowlist for ` idle-detection ` is ` self ` .

##  Specifications

Specification  
---  
[ Idle Detection API  
#  api-permissions-policy  ](https://wicg.github.io/idle-detection/#api-
permissions-policy)  
  
##  Browser compatibility

BCD tables only load in the browser  with JavaScript enabled. Enable
JavaScript to view data.

##  See also

  * [ ` Permissions-Policy ` ](/en-US/docs/Web/HTTP/Headers/Permissions-Policy) header 
  * [ Permissions Policy ](/en-US/docs/Web/HTTP/Permissions_Policy)

##  Help improve MDN

Was this page helpful to you?

Yes  No

[ Learn how to contribute
](https://github.com/mdn/content/blob/main/CONTRIBUTING.md "This will take you
to our contribution guidelines on GitHub.") .

This page was last modified on  Apr 10, 2023  by  [ MDN contributors ](/en-
US/docs/Web/HTTP/Headers/Permissions-Policy/idle-detection/contributors.txt) .

[ View this page on GitHub
](https://github.com/mdn/content/blob/main/files/en-
us/web/http/headers/permissions-policy/idle-detection/index.md?plain=1
"Folder: en-us/web/http/headers/permissions-policy/idle-detection \(Opens in a
new tab\)") â¢  [ Report a problem with this content
](https://github.com/mdn/content/issues/new?template=page-report.yml&mdn-
url=https%3A%2F%2Fdeveloper.mozilla.org%2Fen-
US%2Fdocs%2FWeb%2FHTTP%2FHeaders%2FPermissions-Policy%2Fidle-
detection&metadata=%3C%21--+Do+not+make+changes+below+this+line+--%3E%0A%3Cdetails%3E%0A%3Csummary%3EPage+report+details%3C%2Fsummary%3E%0A%0A*+Folder%3A+%60en-
us%2Fweb%2Fhttp%2Fheaders%2Fpermissions-policy%2Fidle-
detection%60%0A*+MDN+URL%3A+https%3A%2F%2Fdeveloper.mozilla.org%2Fen-
US%2Fdocs%2FWeb%2FHTTP%2FHeaders%2FPermissions-Policy%2Fidle-
detection%0A*+GitHub+URL%3A+https%3A%2F%2Fgithub.com%2Fmdn%2Fcontent%2Fblob%2Fmain%2Ffiles%2Fen-
us%2Fweb%2Fhttp%2Fheaders%2Fpermissions-policy%2Fidle-
detection%2Findex.md%0A*+Last+commit%3A+https%3A%2F%2Fgithub.com%2Fmdn%2Fcontent%2Fcommit%2F0880a90f3811475d78bc4b2c344eb4146f25f66c%0A*+Document+last+modified%3A+2023-04-10T19%3A47%3A15.000Z%0A%0A%3C%2Fdetails%3E
"This will take you to GitHub to file a new issue.")

[ MDN logo  ](/)

Your blueprint for a better internet.

  * [ MDN on Mastodon  ](https://mozilla.social/@mdn)
  * [ MDN on X (formerly Twitter)  ](https://twitter.com/mozdevnet)
  * [ MDN on GitHub  ](https://github.com/mdn/)
  * [ MDN Blog RSS Feed  ](/en-US/blog/rss.xml)

##  MDN

  * [ About ](/en-US/about)
  * [ Blog ](/en-US/blog/)
  * [ Careers ](https://www.mozilla.org/en-US/careers/listings/?team=ProdOps)
  * [ Advertise with us ](/en-US/advertising)

##  Support

  * [ Product help ](https://support.mozilla.org/products/mdn-plus)
  * [ Report an issue ](/en-US/docs/MDN/Community/Issues)

##  Our communities

  * [ MDN Community ](/en-US/community)
  * [ MDN Forum ](https://discourse.mozilla.org/c/mdn/236)
  * [ MDN Chat ](/discord)

##  Developers

  * [ Web Technologies ](/en-US/docs/Web)
  * [ Learn Web Development ](/en-US/docs/Learn)
  * [ MDN Plus ](/en-US/plus)
  * [ Hacks Blog ](https://hacks.mozilla.org/)

[ Mozilla logo  ](https://www.mozilla.org/)

  * [ Website Privacy Notice ](https://www.mozilla.org/priv