← All resources
The toolkit · Resource guide

Render untrusted text safely

Insert plain text into an existing element without interpreting it as HTML.

Visit website (opens in a new tab)
Understand the tool

Overview

Insert plain text into an existing element without interpreting it as HTML.

The example below is an original, minimal illustration of the referenced web-platform feature. Read the official reference and adapt it before using it in a real project.

Best for

  • Understanding render untrusted text safely.
  • Trying the pattern in an isolated page.
  • Adapting the example to an existing website.

Key features

  • Text-only rendering
  • DOM output safety
  • No HTML parsing
A practical walkthrough

Getting started

  1. Read the example and reference. Identify the selectors, files or values that belong to your project.

  2. Try it in isolation. Use a disposable test page and adapt the example values.

  3. Verify before reuse. Check keyboard behavior, responsive layout and relevant browser support.

Things to know

  • These examples are learning material, not a drop-in application.
  • Replace example filenames, selectors and routes as needed.
  • Test changes on staging and escape data for the context where it is used.

Code example

Original illustrative example. Adapt filenames and selectors, and test on staging before reuse.

const preview = document.querySelector('#message-preview');
const userMessage = '<strong>This stays plain text</strong>';
if (preview) preview.textContent = userMessage;

Useful alongside this

Accessibility

Text

Visual

Orientation

Accessibility settings