Guides/Create content/Code/Custom HTML block

Custom HTML block

Last reviewed on November 4, 2025

Use the Custom HTML block to add HTML code and preview it as you edit it. This guide will show you how to use this block to add code to your website.

Add the Custom HTML block

To add the Custom HTML block, click the + block inserter icon and search for “HTML”. Click to add the block to a page, post, or template.

Adding a Custom HTML block.
Adding a Custom HTML block

💡

Using your keyboard, you can also type /html on a new line and press enter to quickly add a new Custom HTML block.

Adding a Custom HTML block with slash inserter.
Adding a Custom HTML block with the slash inserter method

For more information, visit our detailed instructions on adding blocks.

Add your code

Once you’ve added the block, you can type or paste your code in the box provided. Click the Preview option in the block toolbar to see the code rendered.

Editing the Custom HTML block (editor view)
Editing the Custom HTML block (editor view)

You can add code to display content from various services and platforms, including Google Maps, Facebook Pixel, and Google Docs.

Supported code

HTML is a computer language that tells browsers how to display website content. WordPress.com allows the following HTML tags on all plans:

  • a
  • address
  • abbr
  • acronym
  • area
  • article
  • aside
  • b
  • big
  • blockquote
  • br
  • caption
  • cite
  • class
  • code
  • col
  • del
  • details
  • dd
  • div
  • dl
  • dt
  • em
  • figure
  • figcaption
  • footer
  • font
  • h1, h2, h3, h4, h5, h6
  • header
  • hgroup
  • i
  • img
  • ins
  • kbd
  • li
  • map
  • mark
  • ol
  • p
  • pre
  • q
  • rp
  • rt
  • rtc
  • ruby
  • s
  • section
  • small
  • span
  • strike
  • strong
  • sub
  • summary
  • sup
  • table
  • tbody
  • td
  • tfoot
  • th
  • thead
  • tr
  • tt
  • u
  • ul
  • var

For security reasons, not all HTML tags are allowed in the Custom HTML block on all plans. The following tags require a plugin-enabled plan with activated hosting features:

embed, frame, iframe, form, input, object, textarea, script, style, link

For more information on the types of code you can add to your website, as well as alternatives when a type of code is not supported, visit our guide on adding code to your website. This guide describes the various methods to add code to your site, depending on the type of code it is.

Was this guide helpful for you?

Not quite what you're looking for? Get Help!

Copied to clipboard!