Toimii has soft launched, so these guides describe a service you can sign up for and use today. A few pieces are still on the way — the iOS and Android apps arrive later in 2026.

How to embed a contact form on Shopify with Custom Liquid

A Custom Liquid section in the theme editor. No app install, no Liquid knowledge required — paste the two lines and save.

<script src="https://cdn.toimii.io/components/your-code.js" async></script>
<toimii-your-code></toimii-your-code>

Does this actually work?

Yes — if your theme offers a Custom Liquid section. That is Shopify's own answer for adding code to a page without editing theme files.

Step by step

Open the theme editor

In your Shopify admin, open the theme editor on the theme you want to change.

Add a Custom Liquid section

Navigate to the page where the form should appear, then add a section and choose Custom Liquid.

Paste the embed code

Paste the two lines from your component's page in Toimii into the Liquid field. The field takes raw HTML and passes it through unchanged, so the script tag and the custom element work as written.

Save, then check the live storefront

Save in the theme editor, then open the page on your storefront — not the editor preview — and send a test message. A delivered message is the only thing that proves the embed works end to end.

Gotchas

Add the code through the theme editor rather than editing theme files. Shopify updates a theme automatically only while its files are in their original state — and Custom Liquid exists so you can add custom code without touching them. Edit theme code instead and every future update becomes yours to apply by hand.
Checkout and gift card pages don't take sections at all, so a Custom Liquid block can't go on them — on any plan. Put the form on a regular storefront page.
The theme editor edits one theme, and it isn't necessarily the published one. If you saved into a copy, your live store is unchanged however right the preview looks — check the storefront URL, and check which theme is published.

Frequently asked

Do I need a Shopify app from the App Store?

No. Custom Liquid is a built-in theme section, and Shopify's own guidance is to use the theme editor before you reach for code or an app. Not every theme offers it — if yours doesn't, you can still add the two lines to the theme's code, with the update caveat in the gotchas above.

Can I embed it on the checkout page?

No — and it isn't a plan limitation. Shopify's documentation is explicit that sections can be added to any page of your online store except gift card and checkout pages, so there is no Custom Liquid block to put the form in, and no upgrade that adds one. Checkout is customised through checkout apps. Put the form on a contact page or any other storefront page instead.

Will it work in a custom Storefront API site (Hydrogen, Next.js)?

Yes — a headless storefront is your own front end, so the two lines go in it like they would in any other page. One thing to check: Hydrogen ships a default Content-Security-Policy, so allow cdn.toimii.io in script-src and api.toimii.io in connect-src when you build yours.

Embedding on a different platform?

Same two lines of code, picked apart for each platform.

WordPress

Custom HTML block, Block Editor or Classic. No plugin install. One catch — your user role needs the unfiltered_html capability.

Read the full guide

Squarespace

Drop a Code Block on any page. Needs a plan whose code blocks are allowed to run JavaScript.

Read the full guide

Webflow

Drag in a Code Embed element and paste the two lines. Custom code is a paid capability in Webflow — the one condition.

Read the full guide

Wix

Use Wix's Custom Element: your component's script URL in Server URL, its tag in Tag Name. The HTML embed won't work — it's a sandboxed iframe.

Read the full guide

Static Sites

Astro, Hugo, 11ty, Jekyll — same two lines in your layout template. Builds stay fast.

Read the full guide

HTML / Custom

A plain HTML page is enough. Open it in any text editor, paste, save, upload. Three steps and you're live.

Read the full guide

React / Vue / Angular

Use the custom element straight in JSX, Vue templates, or Angular components. No wrapper component, no extra package.

Read the full guide

Ready to try it?

30-day free trial. No credit card. Set up in minutes.

Start free trial

No credit card required. Set up in 2 minutes.