This page is In Progress

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

legend

Summary

The legend element represents a title or explanatory caption for the contents of its parent fieldset element.

Overview Table

DOM Interface
HTMLLegendElement

The legend element represents a caption for the the contents of the legend element’s parent fieldset element, if any.

Examples

Simple form with fieldset, legend, and label elements.

<form action="" method="post">
  <fieldset>
    <legend>User credentials</legend>
    <label for="username">Username</label>
    <input type="text" name="username" id="username">
    <label for="password">Password</label>
    <input type="password" name="password" id="password">
  </fieldset>
</form>

View live example

Usage

 Generally, the legend element can be used in combination with a fieldset element when a group of form elements needs a caption. Pretty similar to a headline element but the legend element is the most semantic element in that case.

Notes

The first legend element in a fieldset is used as the caption of the fieldset. Additional legend elements are ignored.

The legend element will be placed within the border of the fieldset element if you are using a fieldset and leaving the default browser styles untouched. The position will change as soon as you set border: none; to your fieldset.

The »problem« with the fieldset and legend elements is that they don’t behave like normal block/inline elements. A general workaround with any styling and position issues (especially in old IEs) is to wrap your legends content with another element.

<fieldset>
  <legend>Legend link</legend>
</fieldset>

Related specifications

HTML 5.1
W3C Working Draft
HTML 5
W3C Recommendation
HTML 4.01
W3C Recommendation

See also

Related articles

HTML

Other articles

External resources