Form Validations
Server side
We recommend using client-side validation, but in case you require server-side validation, you can
indicate invalid and valid form fields with .is-invalid and .is-valid.
Note that .invalid-feedback is also supported with these classes.
For invalid fields, ensure that the invalid feedback/error message is associated with the relevant
form field using aria-describedby (noting that this attribute allows more than one
id to be referenced, in case the field already points to additional form text).
Preview
HTML
<form class="row g-3">
<div class="col-md-4">
<label for="validationServer01" class="form-label">First name</label>
<input
type="text"
class="form-control is-valid"
id="validationServer01"
value="Mark"
required
/>
<div class="valid-feedback">Looks good!</div>
</div>
<div class="col-md-4">
<label for="validationServer02" class="form-label">Last name</label>
<input
type="text"
class="form-control is-valid"
id="validationServer02"
value="Otto"
required
/>
<div class="valid-feedback">Looks good!</div>
</div>
<div class="col-md-4">
<label for="validationServerUsername" class="form-label">Username</label>
<div class="input-group has-validation">
<span class="input-group-text" id="inputGroupPrepend3">@</span>
<input
type="text"
class="form-control is-invalid"
id="validationServerUsername"
aria-describedby="inputGroupPrepend3 validationServerUsernameFeedback"
required
/>
<div id="validationServerUsernameFeedback" class="invalid-feedback">
Please choose a username.
</div>
</div>
</div>
<div class="col-md-6">
<label for="validationServer03" class="form-label">City</label>
<input
type="text"
class="form-control is-invalid"
id="validationServer03"
aria-describedby="validationServer03Feedback"
required
/>
<div id="validationServer03Feedback" class="invalid-feedback">
Please provide a valid city.
</div>
</div>
<div class="col-md-3">
<label for="validationServer04" class="form-label">State</label>
<select
class="form-select is-invalid"
id="validationServer04"
aria-describedby="validationServer04Feedback"
required
>
<option selected disabled value="">Choose...</option>
<option>...</option>
</select>
<div id="validationServer04Feedback" class="invalid-feedback">
Please select a valid state.
</div>
</div>
<div class="col-md-3">
<label for="validationServer05" class="form-label">Zip</label>
<input
type="text"
class="form-control is-invalid"
id="validationServer05"
aria-describedby="validationServer05Feedback"
required
/>
<div id="validationServer05Feedback" class="invalid-feedback">
Please provide a valid zip.
</div>
</div>
<div class="col-12">
<div class="form-check">
<input
class="form-check-input is-invalid"
type="checkbox"
value=""
id="invalidCheck3"
aria-describedby="invalidCheck3Feedback"
required
/>
<label class="form-check-label" for="invalidCheck3">
Agree to terms and conditions
</label>
<div id="invalidCheck3Feedback" class="invalid-feedback">
You must agree before submitting.
</div>
</div>
</div>
<div class="col-12">
<button class="btn btn-primary" type="submit">Submit form</button>
</div>
</form>
Tooltips
If your form layout allows it, you can swap the .{valid|invalid}-feedback classes for
.{valid|invalid}-tooltip classes to display validation feedback in a styled tooltip.
Be sure to have a parent with position: relative on it for tooltip positioning. In
the example below, our column classes have this already, but your project may require an
alternative setup.
Preview
HTML
<form class="row g-3 was-validated" novalidate>
<div class="col-md-4 position-relative">
<label for="validationTooltip01" class="form-label">First name</label>
<input
type="text"
class="form-control"
id="validationTooltip01"
value="Mark"
required
/>
<div class="valid-tooltip">Looks good!</div>
</div>
<div class="col-md-4 position-relative">
<label for="validationTooltip02" class="form-label">Last name</label>
<input
type="text"
class="form-control"
id="validationTooltip02"
value="Otto"
required
/>
<div class="valid-tooltip">Looks good!</div>
</div>
<div class="col-md-4 position-relative">
<label for="validationTooltipUsername" class="form-label">Username</label>
<div class="input-group has-validation">
<span class="input-group-text" id="validationTooltipUsernamePrepend"
>@</span
>
<input
type="text"
class="form-control"
id="validationTooltipUsername"
aria-describedby="validationTooltipUsernamePrepend"
required
/>
<div class="invalid-tooltip">
Please choose a unique and valid username.
</div>
</div>
</div>
<div class="col-md-6 position-relative">
<label for="validationTooltip03" class="form-label">City</label>
<input type="text" class="form-control" id="validationTooltip03" required />
<div class="invalid-tooltip">Please provide a valid city.</div>
</div>
<div class="col-md-3 position-relative">
<label for="validationTooltip04" class="form-label">State</label>
<select class="form-select" id="validationTooltip04" required>
<option selected disabled value="">Choose...</option>
<option>...</option>
</select>
<div class="invalid-tooltip">Please select a valid state.</div>
</div>
<div class="col-md-3 position-relative">
<label for="validationTooltip05" class="form-label">Zip</label>
<input type="text" class="form-control" id="validationTooltip05" required />
<div class="invalid-tooltip">Please provide a valid zip.</div>
</div>
<div class="col-12">
<button class="btn btn-primary" type="submit">Submit form</button>
</div>
</form>
Supported elements
Validation styles are available for the following form controls and components:
-
<input>s and<textarea>s with.form-control(including up to one.form-controlin input groups) <select>s with.form-select.form-checks
Preview
HTML
<form class="was-validated">
<div class="mb-3">
<label for="validationTextarea" class="form-label">Textarea</label>
<textarea
class="form-control is-invalid"
id="validationTextarea"
placeholder="Required example textarea"
required
></textarea>
<div class="invalid-feedback">Please enter a message in the textarea.</div>
</div>
<div class="form-check mb-3">
<input
type="checkbox"
class="form-check-input"
id="validationFormCheck1"
required
/>
<label class="form-check-label" for="validationFormCheck1"
>Check this checkbox</label
>
<div class="invalid-feedback">Example invalid feedback text</div>
</div>
<div class="form-check">
<input
type="radio"
class="form-check-input"
id="validationFormCheck2"
name="radio-stacked"
required
/>
<label class="form-check-label" for="validationFormCheck2"
>Toggle this radio</label
>
</div>
<div class="form-check mb-3">
<input
type="radio"
class="form-check-input"
id="validationFormCheck3"
name="radio-stacked"
required
/>
<label class="form-check-label" for="validationFormCheck3"
>Or toggle this other radio</label
>
<div class="invalid-feedback">More example invalid feedback text</div>
</div>
<div class="mb-3">
<select class="form-select" required aria-label="select example">
<option value="">Open this select menu</option>
<option value="1">One</option>
<option value="2">Two</option>
<option value="3">Three</option>
</select>
<div class="invalid-feedback">Example invalid select feedback</div>
</div>
<div class="mb-3">
<input
type="file"
class="form-control"
aria-label="file example"
required
/>
<div class="invalid-feedback">Example invalid form file feedback</div>
</div>
<div class="mb-3">
<button class="btn btn-primary" type="submit" disabled>Submit form</button>
</div>
</form>
