Shopify contact

Theme liquid contact form or custom section.

Keys required. Create a site in the dashboard and copy your site key (HTML) and secret key (server). Replace sq_live_your_key in the snippets below.

How this integration works

Same three steps as every other platform — only the paste location and server hook change.

Step	What you do for Shopify contact
1	Add squeaker.js to theme.liquid before </body>.
2	Embed the widget in your contact form template.
3	Use an app proxy or custom endpoint to verify before forwarding.

Where to put the widget

theme.liquid contact form or custom liquid section.

Recommended settings

Setting	Value
Widget mode	Auto (recommended) — Runs on form submit — best for most forms
Server verify	Node.js, PHP

Important notes

Shopify native forms need a server-side verify step via app or proxy.

Copy-paste snippet

Paste into your Shopify contact form or template. Load squeaker.js once per page.

<!-- theme.liquid — before </body> -->
<script src="https://cdn.squeaker.cc/squeaker.js" async defer></script>

<!-- contact form or custom liquid template -->
<squeaker-widget
  data-sitekey="sq_live_your_key"
  data-api="https://api.squeaker.cc/v1"
  data-mode="auto"
  data-theme="light"
  data-form="#my-form"
></squeaker-widget>

<!-- Shopify contact form posts to /contact — use app proxy or webhook + server verify -->

Server verification

Read squeaker-token from the request and POST to /v1/verify with your secret key. Full reference: Server verify docs.

// In your form handler — no npm package required
const apiUrl = process.env.SQUEAKER_API_URL ?? 'https://api.squeaker.cc/v1';
const token = req.body['squeaker-token'];
if (!token) return res.status(400).json({ error: 'Missing token' });

const verifyRes = await fetch(`${apiUrl}/verify`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    secret: process.env.SQUEAKER_SECRET,
    token,
    remoteip: req.ip,
  }),
});
const result = await verifyRes.json();
if (!result.success) {
  return res.status(403).json({ error: result.error ?? 'Invalid token' });
}

// Token valid — process the form

Open setup generator with Shopify contact pre-selected · Browse all platforms