We are working on a new version of Javascript.info with updated content and design.

Using document.write

  1. How document.write works
  2. Open document only
  3. The benefits and uses
  4. Summary

The document.write methods outputs a string directly into page.

This is one of most ancient methods of appending to a document. It is very rarely used in modern web applications, but still it has it’s special place.

How document.write works

When document is loading, a script may document.write(text) into the document. The text will be rendered same way as if it were in HTML.

See the example below:


  document.write('*Hello, there!*')

There are no restrictions on the contents of document.write. It doesn’t have to output valid tags, close them or anything.

In the example below, each document.write outputs a piece of text which is appended to the page.

<script> document.write('<style> td { color: #F40 } </style>') </script>
  <script> document.write('<td>') </script>
   The sun is rising, and I'm happy to welcome it.
  <script> document.write('</td>') </script>

There is also a variation named document.writeln(text) which appends ‘\n’ after the text.

Open document only

There is only one restriction on document.write.

Both document.write and document.writeln method should output text into an unready (open) document.

When the page finishes loading, the document becomes closed. An attempt to document.write in it will cause the contents to be erased.

XHTML and document.write

Mozilla uses XML mode of parsing for any document served with Content-Type: application/xhtml+xml.

In this mode, the browser parses the document as XML which is a fast and cool, but due to technical restrictions of such parsing, the document.write won’t work.

The benefits and uses

In most cases, it is preferred to use DOM for modifications, because it is convenient, and there is innerHTML, which is almost the same.

But document.write is the fastest way to add a script-generated text into the page.

Also, it is used to insert advertising scripts and counters:

  var url = 'http://ads.com/buyme?rand='+Math.random()
  document.write('<script src="'+url+'"></scr'+'ipt>')

  • A script URL is generated dynamically, to allow user-specific data may be added to the URL, like screen resolution and other stuff available from JS.
  • Adding a random value prevents caching even for a force-caching proxy.
  • Note that the closing </SCRIPT> is split. Otherwise browser would think that the script finishes right at that </SCRIPT>.

That's convenient, but a bad way, because loading a script may block the rest of page from rendering. Especially, a problem when the ads server is slow.

Think thrice before inserting a third-party script into HTML.

There is a better way which doesn't block the page. Use the DOM, create SCRIPT element and append it to HEAD.

var script = document.createElement('script')
script.src = 'http://ads.com/buyme?rand='+Math.random()

// now append the script into HEAD, it will fetched and executed

Using DOM doesn’t block the page and makes the page faster and safe from third-party lags.


The document.write (or writeln) allows to output a text directly into HTML. It deletes (reopens) the whole document if called after page loading.

The advantages of document.write are:

  1. It can append arbitrary, even partial, incomplete and malformed HTML into document.
  2. It is very fast, because the browser doesn’t have to modify an existing DOM structure.

Sometimes the scripts are added by the document.write. Don’t use this method, as the rest of the page will await for script loading and execution.

If the remote server hands up, the page will may take too much to load. And, anyway, why should the page wait for the remote server?

Try to replace document.write with DOM methods, if remote architecture allows that.