Skip to main content

Shopify blog HTML editing: what the built-in editor covers, and what to do instead

10 min readSmart Agent Blog Editorial Team
Shopify blog HTML editing cover image showing an example article with a callout, a comparison table, and a speech balloon

You want a box around one warning. You want slightly less space under a heading. Writing stops, and layout takes over. Deciding up front whether to touch HTML at all saves you the afternoon.

Short answer: Shopify's built-in rich text editor has a Show HTML button, and you can rewrite the post's markup in place. But Shopify automatically corrects markup it considers risky, so what you type does not always survive the save. Smart Agent Blog takes the other route — design editing changes how a block looks without code, and Add Custom Block builds your own block from HTML and CSS. Both are paid-plan features.

This guide covers the built-in editor properly first, then shows where you can get the same result without writing a line.

What you'll learn
  • How to edit post markup with Show HTML, step by step
  • Why Shopify rewrites HTML on save, and what to check afterwards
  • Three checks to run before you touch HTML at all
  • How design editing, the Code block, and custom blocks differ
  • A side-by-side comparison and a pre-publish checklist

People reach for HTML when the formatting options run out​

While preparing proposals for Smart Agent Blog in August and September 2026, we reviewed the blogs of 110 Shopify stores in Japan. Across the 113 posts we recorded, not one used a card that pulls together a product's name, image, and price.

Building that kind of card with the built-in editor alone means writing HTML. So "I need to edit the HTML" usually is not about HTML at all — it is about running out of formatting options. That is worth a pause before you start typing.

Three checks before you touch HTML: 1 name the one thing you want to change, 2 see if a block already does it, 3 test on one hidden post, which you check yourself

The second check does most of the work. If a quote, a callout, a table, or a 2 Column layout gets you there, skip the HTML — it is faster and nothing breaks. We cover boxes in callout blocks for important notes, side-by-side data in comparison tables in Shopify blog posts, and image-plus-text layouts in two and three column layouts.

Here is what that range looks like in a finished post. This is a fictional store, used as an example.

Example article from fictional store KINARI CANVAS with 1 a red callout warning, 2 a fabric care comparison table, and 3 an owner speech balloon
1 callout, 2 table, 3 speech balloon — all three are blocks, not code

What Shopify does on its own​

In Shopify admin, open Content → Blog posts and select a post. The body uses the rich text editor, which handles both visual formatting and direct HTML editing.

What the toolbar offers​

According to the Shopify Help Center, the rich text editor toolbar includes:

  • Formatting (paragraph, headings 1–6, blockquote)
  • Bold, Italic, Underline, Color, Clear formatting
  • Bulleted list, Numbered list, Indent, Outdent, Alignment
  • Insert table, Insert link, Insert image, Insert video
  • Show HTML

Tables are supported out of the box. It is a common misconception that Shopify cannot do tables — you do not need HTML for a comparison table.

Editing with Show HTML​

  1. In Shopify admin, open Content → Blog posts and select the post you want to edit.
  2. In the body toolbar, select Show HTML. The post's markup appears.
  3. Edit the part you want to change. The Help Center describes this view as the place to view the HTML and remove markup that is causing a display problem.
  4. Select Show HTML again to return to the normal view and confirm the result.
  5. Select Save.

An empty paragraph leaving a gap you cannot delete, or styling that came along with text pasted from elsewhere — these "make it go away" jobs are fastest here.

Your markup may not survive the save​

Shopify's rich text editor runs content filtering that automatically corrects HTML which could malfunction on the storefront or create a security risk. The Help Center recommends accepting those automatic corrections.

There is one practical consequence: after saving, open Show HTML again and confirm your markup is still there. If it is gone, that is the filter doing its job, not a bug. You will need another way to get the same look.

What the built-in editor cannot do​

  • Generate a table of contents from your headings and keep it updated
  • Place a product card with name, image, price, and stock status
  • Save a look as a reusable block you can call up in the next post

Links are inserted by typing a URL, so a product mention stays a text link in the sentence.

Where hand-written HTML stops scaling​

Fixing one post is fine. The trouble starts once you have a shelf of them.

  • You paste it again every time. The same box across ten posts means ten pastes.
  • Theme updates change how it renders. Post markup sits inside the theme's CSS.
  • The next person cannot touch it. Code does not say which parts are safe to edit.
  • It breaks on phones. Fixed pixel widths overflow on a 375px screen.

On phone rendering, see making Shopify blog posts readable on mobile.

Advanced editing in Smart Agent Blog​

Smart Agent Blog builds the body out of blocks. Advanced editing applies to a block, not to a blob of markup.

Design editing (the pencil icon)​

Headings, quotes, callouts, and speech balloons in the insert menu carry a pencil icon. That is design editing: it changes how the block looks, from the screen, with no HTML or CSS.

Smart Agent Blog insert menu with the Quote button marked 1, showing the pencil icon in its top-right corner
The pencil icon on Quote is the entrance to design editing

Heading underline color, the rule beside a quote, callout background — the "make it feel like our store" layer lives here, and you set it once instead of per post.

The Code block shows code, it does not run it​

The Code block in the insert menu displays code exactly as written, for readers. HTML you put there does not execute on your storefront. Use it when a post explains how to write a tag.

Smart Agent Blog insert menu with 1 the Code button and 2 the Callout button marked, Callout showing a pencil icon
1 Code displays code as text. 2 Callout carries a pencil, so its look is editable

Add Custom Block​

Add Custom Block, at the bottom of the insert menu, builds your own block from HTML and CSS. It suits shapes you reuse — a house-style warning box, a recurring heading ornament.

The rules:

  • The HTML style attribute is accepted
  • JavaScript cannot be used
  • Liquid is not processed; the tag appears as plain text

This needs real HTML and CSS knowledge and can break the storefront, so skip it if you are unsure. Never paste code from a source you do not trust, and test on a duplicated theme or a hidden article first. The full procedure is in safely switch from your existing blog.

Design editing and custom blocks are both paid-plan features; on the free plan a notice appears when you try to use them. Block-by-block instructions live in add content to an article.

The two routes, side by side​

Comparison table of Shopify Show HTML and Smart Agent Blog advanced editing across what it does, knowledge needed, safety net, Liquid, reuse, cost, and best use

This is not an either-or. Use Show HTML to fix one broken spot; use blocks to make every post look the same. For the whole writing workflow, see how to write a Shopify blog post. For styling with stylesheets, see custom CSS for Shopify blogs.

Before you publish​

Checklist for touching HTML: before, after saving, after publishing, and next post

The easiest one to skip is reopening Show HTML after the save. If the filter changed something, you would otherwise find out after the post is live.

FAQ​

Will the HTML in my existing posts disappear if I install the app?​

Articles that appear in the Smart Agent Blog article list can be opened and edited. Posts containing unusual markup or content specific to another app may render differently, so check on a hidden article or a duplicated theme before switching your live theme.

Can a custom block contain JavaScript or Liquid?​

No JavaScript. Liquid is not processed — the tag shows up as plain text. What works is HTML, CSS, and the HTML style attribute.

Can I try advanced editing on the free plan?​

Design editing and custom blocks are paid-plan features, and a notice appears on the free plan. The blocks themselves — headings, quotes, callouts, speech balloons, tables, columns — work on the free plan, so check whether those are enough first. Plan conditions are listed in plans and usage limits.

Summary​

  • The built-in rich text editor has Show HTML, and you can edit post markup directly
  • Shopify automatically corrects risky markup, so reopen Show HTML after saving and confirm
  • Before writing any HTML: narrow it to one change, check whether a block does it, test on a hidden post
  • In Smart Agent Blog, design editing handles the look and custom blocks hold the shapes you reuse (paid plans)

Write down the single thing you most want to change, then check whether a block already does it. That one step decides whether you need HTML at all.

Back to articles →

Make your Shopify blog work better.

From planning and writing to analysis and improvement.

User guideShopify App Store ↗