Basker Docs

HTML (in rich text)

Drop a snippet of custom HTML inline within a block of formatted text.

The HTML option lets you paste raw HTML directly into a block of formatted text — a third-party embed, a partner widget, or markup a developer handed you. It drops in at your cursor without breaking the paragraph, and is for the cases where the regular editor can't produce what you need.

Insert it from the editor's insert menu, under the Basic group. It is one of three things you can place inside a block of formatted text: an inline button, a piece of media, or this HTML snippet.

The field

HTML — a code box where you paste or edit your markup. There are no other settings.

What renders, and what gets removed

Your HTML is cleaned up when the page is shown to visitors, so what you paste is not always what appears. Most everyday embed markup survives:

  • Standard content tags — headings, paragraphs, lists, links, tables, and figures.
  • Media tags — img, picture, audio, and video.
  • Embeds that use an iframe — most maps, video players, and many widgets, since iframe is allowed.
  • Inline styling — a style attribute, a class, and data-* attributes.

Links are limited to standard web, email, and phone addresses (http, https, mailto, tel). Tags and attributes outside the permitted set are stripped, and inline event handlers such as onclick are always removed.

Scripts will not run from this block

Any <script> you paste here is removed before the page renders, so tracking pixels, analytics, and script-based embeds will not work from an HTML snippet. Put marketing and analytics code in your theme's Custom Code settings, or load it through your tag manager. An external script is only allowed to run if its source domain has been added to your site's trusted-embed list — a setting an administrator configures — and no domains are trusted by default. Approved third-party embeds may include their own custom widget elements, which are allowed through alongside the trusted script.

Because the cleanup happens at render time, the safest way to confirm a snippet works is to preview the page and check the result rather than trusting the editor view.

Shared controls

The HTML snippet has no layout, background, or spacing controls of its own — it sits inline wherever you place it, and follows the formatting of the surrounding text. For everything else the surrounding block offers, see The rich text editor.

Worked example

To embed a map from a service that provides iframe code:

Copy the embed code

From the map provider, copy the embed snippet. Confirm it is an <iframe> embed rather than a script-based one — script embeds will not run here.

Insert the HTML option

Place your cursor where the map should appear in the text, open the editor's insert menu, choose the Basic group, and select HTML.

Paste and preview

Paste the snippet into the HTML box, then preview the page to confirm the map renders as expected before publishing.

Where to go next

On this page