Skip to content

Editor & content hub — FlexiBlocks

FlexiBlocks does not replace Shopify’s native body editor. It adds Edit in FlexiBlocks as an alternative that reads and writes the same Shopify HTML fields (body on articles and pages, descriptionHtml on products and collections, or your mapped metaobject field).


From the app home (Content hub) you can open:

Card What you edit
Blog posts Article body HTML (pick a blog, then an article)
Pages Online Store page body HTML
Reusable blocks Shop-wide library entries (/library/reusable-blocks)
Products Product description HTML
Collections Collection description HTML
Metaobjects Enabled custom types — configure first in Settings → Content types

Use Settings (top of hub) for app setup.

Content hub for posts, pages, products, and collections
Content hub. Settings is at the top of this screen.

The editor is the WordPress Gutenberg block editor (WordPress block library + FlexiBlocks shopify/* blocks).

Editorial & layout: paragraphs, headings, lists, quotes, columns, spacers, separators, groups, buttons, tables, FAQ (details), accordion, tabs, custom HTML, table of contents, math.

Media: image, gallery, cover, media & text — images use Shopify Files (not WordPress media).

Embeds: YouTube and Vimeo via the core embed block.

Commerce: product card, product cards, buy button, collection grid, collection button — see Commerce blocks.

Reusable: insert reusable block references from the library (not nested inside another library entry).

Many WordPress-only blocks (posts, comments, site logo, etc.) are hidden intentionally.

FlexiBlocks editor with the block inserter open
Editor with the block inserter open.

Paste one post at a time. FlexiBlocks does not upload a WordPress export file.

  1. In WordPress, open the post and switch to the Code editor. Copy the HTML, including the <!-- wp: --> comments.
  2. In Shopify Admin, open the article, page, product, or collection and paste that HTML into the native HTML view. Save.
  3. Open the same resource in FlexiBlocks before you have saved it there. The editor turns the pasted HTML into blocks.

Do this on a resource that has not been saved in FlexiBlocks yet. After the first FlexiBlocks save, the editor reopens the saved blocks rather than a new paste.

Headings, paragraphs, lists, quotes, images, buttons, columns, and YouTube or Vimeo embeds come across as blocks. Other WordPress blocks may need a manual fix. Images keep their current web address until you replace them from Shopify Files.


If your shop has two or more published locales, the editor shows a locale switcher. Non-primary locales save through Shopify’s translations flow; the primary locale uses the standard Admin fields.

Reusable block references are stored on the primary locale; translated bodies embed the same library content when expanded at save.

Shop languages are managed in Shopify Admin → Settings → Languages (Markets).


Data Location
Published HTML Shopify native field (body, descriptionHtml, or mapped metaobject field)
Block JSON for re-editing App metafield $app:gutenberg.data
Reusable refs list App metafield $app:gutenberg.reusable_refs (resources)
Reusable library Metaobject $app:gutenberg_reusable_block

We do not keep a separate long-term copy of your HTML outside Shopify except during save/load and short-lived server logs.


  1. Click Save in FlexiBlocks.
  2. The worker refreshes commerce block attributes, expands reusable references, and writes storefront-ready HTML.
  3. Shopify fields update via the Admin API (body + metafields).
  4. Refresh the resource in Shopify Admin to see the same HTML in the native editor.

If save fails, see Troubleshooting.


Tab Purpose
General Editor appearance, theme CSS for the canvas, Editor presets, Storefront content selectors

Editor theme styles on that tab is where you match the canvas to your theme. Paste a short block of theme CSS, or a theme stylesheet URL, then choose Save theme styles. Headings in the editor pick up rules such as .rte h2.

Editor theme styles in FlexiBlocks settings
Settings → General → Editor theme styles. Paste theme CSS, then save.
| **Content types** | Enable metaobject types for the hub — [Metaobjects](/docs/en/metaobjects/) | | **Storefront** | Embed enablement checklist and theme-editor deep link | | **Installation** | Metafield + reusable block definition setup — required for the library |