Add content to an article
The body can contain text, images, products, tables, videos, speech balloons, and more. This guide calls each self-contained item a “block.”
Two ways to add content
Type a forward slash
Start a new line, type / at the beginning of it, and choose the content you want. Move through the list with the arrow keys and confirm with Enter, or select an item with the mouse. Press Esc to close it. Continue typing to narrow the list, for example /head or /table.
The list does not open inside a code block. Start a new line outside the code block instead.
Use the insert menu
You can also use the insert menu beside the article settings. Selecting an item adds it at the cursor. The eye icon above the menu shows or hides it, and the choice is remembered for the store.
Available blocks
The / list contains:
| Block | Good for |
|---|---|
| Heading 1–5 | Marking where the topic changes |
| Bold | Emphasising an important word |
| Bullet List | Listing features in short lines |
| Numbered List | Showing steps in order |
| Code | Showing code exactly as written |
| Quote | Quoting a customer or another source |
| Create a table | Comparing sizes or differences |
| Table of Contents | Moving around a long article |
| 2 Column / 3 Column | Placing an image beside its description |
| Image | Showing a product in use |
| Video | Showing something text cannot explain |
| Product Insert | Sending readers to one product page |
| Collection Insert | Presenting a related group of products |
| Callout | Highlighting an important condition |
| Speech Balloon | Adding a staff comment as conversation |
The insert menu additionally offers Italic, Underline, and Color.
Add an image
Choose Image, then either enter an image URL, select File Upload to upload from your computer, or pick a file from the images already in Shopify. Dragging or pasting an image file directly into the body also works, and uploads it to Shopify automatically.
Check the size and alignment afterwards, and add nearby text so the meaning does not depend on the image alone.
Add a video
Choose Video, then enter a video file URL, enter a YouTube URL, upload a file, or pick one of the videos already in Shopify. Uploading can take a while — leave the dialog open until the progress indicator finishes.
Add a product
Choose Product Insert and select a product from Shopify. The block is added with the product name, image, and price, and shows a sold-out label when the product is out of stock. Draft, hidden, and archived products cannot be selected — publish them in Shopify admin first.
The final appearance depends on your theme, so always preview before publishing.
Add a collection
Collection Insert displays products from one Shopify collection together with their images, names, and prices.
- Choose Collection Insert where you want the collection to appear.
- Select one Shopify collection.
- In the inserted block, select Edit collection block.
- Adjust the heading, description, product limit, and desktop and mobile columns, then select Apply.
The same editor can control the product-image ratio and shape, ratings, the View all link when more products exist, and horizontal swiping on mobile.
Product data comes from the Shopify collection. After changing its products or prices, open the storefront article and confirm that the current information appears.
Use Collection Insert to compare or present several related products. Use Product Insert when the article should focus on one product.
Add a table of contents
Table of Contents builds itself from the headings in the article and updates as you edit them. It lists Heading 2, Heading 3, and Heading 4 only — Heading 1 and Heading 5 are not included. Until a matching heading exists, the block shows "No headings yet".
Reorder or delete blocks
Hover over a block to reveal a handle on its left. Drag the handle to move the block up or down, or select it to open a menu with Delete. For a speech balloon, the same menu switches the image between the left and right side. After moving a block, check that the surrounding text still reads naturally.
Advanced editing
Headings, quotes, callouts, and speech balloons in the insert menu carry a pencil icon for design editing, and Add Custom Block at the bottom of the menu creates your own block from HTML and CSS. Both features require a paid plan.
Custom blocks accept the HTML style attribute. JavaScript cannot be used, and Liquid tags are not processed — they appear as plain text. These features need HTML and CSS knowledge and can break the storefront, so avoid them if you are unsure. Test uncertain code on a duplicated theme or hidden article.
Code from an untrusted source can break the storefront or expose information.