The WebPlatform project has been discontinued when the Stewards partnership agreement ended in September 2015. This site has been frozen, and the assets we have created will remain.


< html‎ | elements
Jump to: navigation, search


This article is In Progress.


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.


Simple form with fieldset, legend, and label elements.


<form action="" method="post">
    <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"> 

View live example


 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.


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.

  <legend><span>Legend link</span></legend>

Related specifications

Specification Status Related Changes
HTML 5.1 W3C Working Draft
HTML 5 W3C Recommendation
HTML 4.01 W3C Recommendation

See also

Related articles


  • legend

Other articles

External resources