The document.title
property gets or sets the current title of the document.
Syntax
var docTitle = document.title;
docTitle is a string containing the document's title. If the title was overridden by setting document.title
, it contains that value. Otherwise, it contains the title specified in the markup (see the Notes below).
document.title = newTitle;
newTitle
is the new title of the document. The assignment affects the return value of document.title
, the title displayed for the document (e.g. in the titlebar of the window or tab), and it also affects the DOM of the document (e.g. the content of the <title>
element in an HTML document).
Example
<!DOCTYPE html> <html> <head> <title>Hello World!</title> </head> <body> <script> alert(document.title); // displays "Hello World!" document.title = "Goodbye World!"; alert(document.title); // displays "Goodbye World!" </script> </body> </html>
Notes
This property applies to HTML, SVG, XUL, and other documents in Gecko.
For HTML documents the initial value of document.title
is the text content of the <title>
element. For XUL it's the value of the title
attribute of the <xul:window>
or other top-level XUL element.
In XUL, accessing document.title
before the document is fully loaded has undefined behavior: document.title
may return an empty string and setting document.title
may have no effect.
Specifications
Specification | Status | Comment |
---|---|---|
HTML Living Standard The definition of 'document.title' in that specification. |
Living Standard |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
title | Chrome Full support 1 | Edge Full support 12 | Firefox Full support Yes | IE Full support Yes | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support Yes | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes |
Legend
- Full support
- Full support