<body>: The Document Body element

BaselineWidely available

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

The<body>HTML element represents the content of an HTML document. There can be only one<body> element in a document.

Attributes

This element includes theglobal attributes, event attributes, and deprecated attributes:

Note:Each of the below event attribute names is linked to its equivalentWindow interface event. You can listen to these events usingaddEventListener() instead of adding theoneventname attribute to the<body> element.

onafterprint: Function to call after the user has printed the document.
onbeforeprint: Function to call when the user requests printing of the document.
onbeforeunload: Function to call when the document is about to be unloaded.
onblur: Function to call when the document loses focus.
onerror: Function to call when the document fails to load properly.
onfocus: Function to call when the document receives focus.
onhashchange: Function to call when the fragment identifier part (starting with the hash ('#') character) of the document's current address has changed.
onlanguagechange: Function to call when the preferred languages changed.
onload: Function to call when the document has finished loading.
onmessage: Function to call when the document has received a message.
onmessageerror: Function to call when the document has received a message that cannot be deserialized.
onoffline: Function to call when network communication has failed.
ononline: Function to call when network communication has been restored.
onpageswap: Function to call when you navigate across documents, when the previous document is about to unload.
onpagehide: Function to call when the browser hides the current page in the process of presenting a different page from the session's history.
onpagereveal: Function to call when a document is first rendered, either when loading a fresh document from the network or activating a document.
onpageshow: Function to call when the browser displays the window's document due to navigation.
onpopstate: Function to call when the user has navigated session history.
onresize: Function to call when the document has been resized.
onrejectionhandled: Function to call when a JavaScriptPromise is handled late.
onstorage: Function to call when the storage area has changed.
onunhandledrejection: Function to call when a JavaScriptPromise that has no rejection handler is rejected.
onunload: Function to call when the document is going away.

Deprecated attributes

Warning:Do not use these deprecated attributes; opt for the CSS alternatives listed with each deprecated attribute instead.

alinkDeprecated: Color of text for hyperlinks when selected.Use the CSScolor property in conjunction with the:active and:focus pseudo-classes instead.
backgroundDeprecated: URI of an image to use as a background.Use the CSSbackground-image property instead.
bgcolorDeprecated: Background color for the document.Use the CSSbackground-color property instead.
bottommarginDeprecated: The margin of the bottom of the body.Use the CSSmargin-bottom property (or the logicalmargin-block-end property) instead.
leftmarginDeprecated: The margin of the left of the body.Use the CSSmargin-left property (or the logicalmargin-inline-start property) instead.
linkDeprecated: Color of text for unvisited hypertext links.Use the CSScolor property in conjunction with the:link pseudo-class instead.
rightmarginDeprecated: The margin of the right of the body.Use the CSSmargin-right property or the logicalmargin-inline-end property) instead.
textDeprecated: Foreground color of text.Use the CSScolor property instead.
topmarginDeprecated: The margin of the top of the body.Use the CSSmargin-top property (or the logicalmargin-block-start property) instead.
vlinkDeprecated: Color of text for visited hypertext links.Use the CSScolor property in conjunction with the:visited pseudo-class instead.

Examples

html

<html lang="en">  <head>    <title>Document title</title>  </head>  <body>    <p>      The <code>&lt;body&gt;</code> HTML element represents the content of an      HTML document. There can be only one <code>&lt;body&gt;</code> element in      a document.    </p>  </body></html>

Result

Technical summary

Content categories	None.
Permitted content	Flow content.
Tag omission	The start tag may be omitted if the first thing inside it is not a space character, comment,`<script>` element or`<style>` element. The end tag may be omitted if the`<body>` element has contents or has a start tag, and is not immediately followed by a comment.
Permitted parents	It must be the second element of an`<html>` element.
Implicit ARIA role	`generic`
Permitted ARIA roles	No`role` permitted
DOM interface	`HTMLBodyElement` The`<body>` element exposes the`HTMLBodyElement` interface. You can access the`<body>` element through the`document.body` property.