The Face Detection API is a subset of the Shape Detection API which provides the ability to detect human faces and facial landmarks in an image provided by script. The image may come from any type of image buffer source such as an <image>, <video> or <canvas> tag.


Native platforms such as Android, iOS, macOS and Windows include built-in libraries for performing the detection of faces in images. The availability of these libraries means that developers do not need to design this functionality themselves or include a large third party face detection library in their application download. This API provides these same benefits to the web platform where it is available on native.




Specification link

Unknown standards status - check spec link for status

Status in Chromium


In developer trial (Behind a flag) (tracking bug)

Consensus & Standardization

After a feature ships in Chrome, the values listed here are not guaranteed to be up to date.

  • No signal
  • No signal
  • Positive



This feature depends on built-in face detection support which is only provided by Android, macOS* and Windows 10 at the moment. * Detection performance is improved in 10.13 through use of hardware acceleration in the Vision Framework.

Last updated on 2021-12-13