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

The simplest way to add a contact form to a plain HTML page

Two lines anywhere in <body>. No build step, no dependencies. If you can save and upload, you can do this.

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

Does this actually work?

Yes — and this is the simplest case. Plain HTML has no plugin sandboxing, no editor strips scripts, no plan tier. The two lines work anywhere you can save and upload an .html file.

Step by step

Open your .html file

Open the .html file you want the form on, in any text editor — VS Code, Sublime, Notepad++, even TextEdit (in plain text mode).

Paste the embed code

Paste the two lines from your Toimii dashboard inside <body>, exactly where you want the form to appear.

Save and upload

Save the file and upload it to your hosting — FTP, S3, Netlify drop, whatever you use. Open the page in a browser to confirm.

Common gotchas

Don't paste the snippet inside <head>. The custom element is a body-level tag — it has to live inside <body>.
Don't drop the async attribute on the script tag. Without it, the script blocks the rest of the page from rendering.
If you copy and paste from a rich-text editor, you may get smart quotes (" ") instead of straight quotes ("). Use a plain text editor — VS Code, Sublime, Notepad, TextEdit in plain text mode.
If your page already has Content-Security-Policy meta tags, allow cdn.toimii.io in script-src and connect-src. Most plain HTML pages don't have a CSP at all.

Frequently asked

Do I need a backend or PHP?

No backend needed. Submissions go straight from the form to Toimii's API — your HTML page can be served from anywhere, even a free static host.

Can I open the .html file directly with file://?

It depends on the browser. Chrome and Safari open .html files via file:// without trouble; Firefox blocks cross-origin scripts on file:// URLs. For reliable testing, run a tiny local server (npx serve, python -m http.server) and open http://localhost.

Will it work in CodePen, JSFiddle, or a sandbox?

Yes — paste the two lines into the HTML pane. The script will load and the component will render in the preview iframe.

Does it work offline?

The page loads, but the form needs network access to submit. If a visitor is offline, the page renders fine — they just can't send the message until they're back online.

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

Shopify

Add a Custom Liquid section to any theme — no app install required. Skip checkout pages unless you're on Shopify Plus.

Read the full guide

Static Sites

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

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.