HTML attribute: minlength

The minlength attribute defines the minimum number of characters (as UTF-16 code units) the user can enter into an <input> or <textarea>. This must be an integer value 0 or higher. If no minlength is specified, or an invalid value is specified, the input has no minimum length. This value must be less than or equal to the value of maxlength, otherwise the value will never be valid, as it is impossible to meet both criteria.

The input will fail constraint validation if the length of the text value of the field is less than minlength UTF-16 code units long, with validityState.tooShort returning true. Constraint validation is only applied when the value is changed by the user. Once submission fails, some browsers will display an error message indicating the minimum length required and the current length.

Examples

By adding minlength="5", the value must either be empty or five characters or longer to be valid.

<label for="fruit">Enter a fruit name that is at least 5 letters long</label> <input type="text" minlength="5&quot id="fruit">

We can use pseudoclasses to style the element based on whether the value is valid. The value will be valid as long as it is either null (empty) or five or more characters long. Lime is invalid, lemon is valid.

input {
  border: 2px solid currentColor;
}
input:invalid {
  border: 2px dashed red;
}
input:invalid:focus {
  background-image: linear-gradient(pink, lightgreen);
}

Specifications

Specification Status
HTML Living Standard
The definition of 'minlength attribute' in that specification.
Living Standard
HTML 5.1
The definition of 'minlength attribute' in that specification.
Recommendation

Browser compatibility

No compatibility data found. Please contribute data for "html.elements.attribute.minlength" (depth: 1) to the MDN compatibility data repository.

See also