HTMLInputElement: minLength property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

The minLength property of the HTMLInputElement interface indicates the minimum number of characters (in UTF-16 code units) required for the value of the <input> element to be valid. It reflects the element's minlength attribute. -1 means there is no minimum length requirement.

Note: If the input has a value, and that value has fewer characters than the minlength attribute requires, the element is considered invalid and the ValidityState object's tooShort property will be true.

Value

A number representing the element's minlength if present or -1.

Example

Given the following HTML:

html
<p>
  <label for="password">Your password</label>
  <input id="password" type="password" minlength="8" maxlength="20" />
</p>

You can use the minLength property to retrieve or set the <input>'s minlength attribute value:

js
const inputElement = document.querySelector("#password");
console.log(`Element's minLength: ${inputElement.minLength}`); // "Element's minlength: 8"
inputElement.minLength = 12; // updates the element's minlength attribute value

Specifications

Specification
HTML Standard
# dom-input-minlength

Browser compatibility

BCD tables only load in the browser

See also