This page is Almost Ready

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.



Gets the y-coordinate of the mouse pointer, relative to the upper-left corner of the viewport (that is, the user agent’s client area).

Property of dom/MouseEventdom/MouseEvent


Note: This property is read-only.

var yCoordinate = event.clientY;

Return Value

Returns an object of type NumberNumber

The Y coordinate of the mouse cursor.


This example uses the clientY property to determine the mouse position relative to the window. The console shows the mouse position at all times.

<!doctype html>
function logClientCoords() {
  console.log("The x coordinate is: " + e.clientX + "The y coordinate is: " + e.clientY);
function logCursorPosition(e) {
  console.log("X = " + e.clientX + " Y = ' + e.clientY);
window.addEventListener("move", logCursorPosition, false);
window.addEventListener("click", logClientCoords, false)


Client coordinates do not reflect the scroll offset of the page. To get the mouse pointer’s coordinates relative to the upper-left corner of the document, use the pageX and pageY properties.

Related specifications

DOM Level 3 Events
Working Draft