These guides describe Toimii once it's live. The dashboard and billing aren't available yet — Toimii launches in 2026.

How to embed a contact form on Shopify with Custom Liquid

A Custom Liquid section in any theme. No app install, no Liquid knowledge required — just paste the two lines.

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

Does this actually work?

Yes — on every Shopify theme that supports Online Store 2.0 (Dawn and any modern theme). The Custom Liquid section is built into Shopify; no app install, no theme code editing required for most pages.

Step by step

Open the theme editor

From your Shopify admin, go to Online Store → Themes → Customize on the theme you want to edit.

Add a Custom Liquid section

Pick the page where the form should appear (a Page, the Contact page, or any page template). Click Add section and choose Custom Liquid.

Paste the embed code

Paste the two lines from your Toimii dashboard into the Liquid field. Liquid passes raw HTML through unchanged, so the script tag and custom element work as written.

Save the theme

Save in the theme editor. The form is live on the storefront immediately.

Test on the live storefront

Open the live page (not the preview) and submit a test message to confirm it works end-to-end. If something looks off, see the gotchas below.

Common gotchas

Direct theme.liquid edits get overwritten on theme update. Use the Custom Liquid section in the theme editor (saved per-page) or duplicate the theme before editing core files.
Custom Liquid on checkout pages requires Shopify Plus. On standard plans, embed on contact, FAQ, or product pages instead.
Some themes have a built-in CSP that blocks third-party scripts. If the form doesn't render, allow cdn.toimii.io and api.toimii.io in script-src / connect-src.
The theme editor preview sometimes lazy-loads sections in a way that breaks first-render of custom elements. View the page on the live storefront URL (or use the "View" button) to confirm — preview is not the source of truth.
If you wrap the form in a Liquid {% if %} block, the script still loads on every page. To save bytes, gate the script tag with the same condition.

Frequently asked

Do I need a Shopify app from the App Store?

No. Custom Liquid is a built-in Shopify theme section — every theme from Dawn onward supports it. App stores are full of "contact form" apps; you don't need any of them for Toimii.

Can I embed it on the checkout page?

Not on standard plans. Custom Liquid on checkout pages requires Shopify Plus. On non-Plus stores, embed the form on a contact page, FAQ page, or post-purchase order status page instead.

Will theme updates wipe out my embed code?

Yes — direct edits to theme files (theme.liquid, sections/*.liquid) get overwritten when you update or restore the theme. Two safer options: use a theme section + Custom Liquid block (saved per-page in the theme editor), or duplicate the theme before editing.

My store has a Content-Security-Policy — does that block Toimii?

A few stores have a strict Content-Security-Policy via theme settings or apps like Shopify's Online Store 2.0 themes with CSP headers. If the form doesn't render, allow these in script-src: cdn.toimii.io and api.toimii.io.

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

Yes. Use the App Bridge to render an HTML container, then inject the script tag and custom element into it. Same approach: two lines of code, custom element does the rest.

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. Requires the Core plan (2025 rename of Business) or higher.

Read the full guide

Webflow

The Code Embed element holds up to 50,000 characters. Custom code requires the Basic plan or above. Publish to preview.

Read the full guide

Wix

Wix sandboxes the Embed widget, so we use a split method — script in Settings → Custom Code, tag via Embed a Widget. Honest guide.

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.

No credit card required. Set up in 2 minutes.