Troubleshooting

Most snags in Formtoro come down to a handful of causes. Here are the common ones and how to fix them fast.

My form isn't showing on the storefront

The most common one. Walk the going-live checklist:

1. The form is Published (not Draft or Paused).
2. Formtoro is turned on in your theme — for popups, Online Store → Themes → Customize → App embeds → Formtoro Popups; for inline forms, the Formtoro Form block is added to a section.
3. Your custom domain is allowed (Settings → Storefront domains).
4. The visitor matches the audience.
5. You haven't already seen it this period (check frequency).

Fastest check: open your store in a private/incognito window that matches the audience — that clears any "already seen/dismissed" state.

My discount isn't applying at checkout

• For a magic discount, the reward applies automatically — confirm the form actually has the magic discount attached, and check the discount's diagnostics panel on the Discounts page for its function status.
• For a static code, the shopper has to copy and paste it — and the matching code must exist and be active in Shopify.
• If you just created or changed the discount, give Shopify a moment and re-test.

My consent links are blank or wrong

Consent policy links are baked into a form when you publish it. If you set or changed your Terms of Service / Privacy Policy URLs (Settings → Legal & compliance) after publishing, republish the affected forms so the links update. Also make sure your consent copy includes the {{terms}} and {{privacy}} tokens — without them, there are no links to show.

I changed a setting but the storefront didn't update

Some things compile into a form at publish time (consent links, and theme/brand changes you want reflected in an already-live form). Republish the form to push those changes live.

A form shows once and never again

That's your display frequency working as configured. Until completed, Once ever, and Once per session all intentionally stop re-showing. To see it again while testing, use a private/incognito window, or set the frequency to Every visit temporarily. See Display, teasers & triggers.

I can't find where to rename a field's "key"

Field names (the keys your answers are stored under, like email or shopping_interest) are assigned automatically and aren't edited in the inspector. You can freely edit a field's visible label. See the fields reference.

I'm looking for a control that isn't there

A few options exist in the data model but aren't surfaced in the builder yet — for example min/max selections on choice questions and min/max dates on a date field. If you can't find a control, it may be a planned addition rather than a hidden setting. The fields reference lists what's configurable today.

A dashboard number shows "—"

A dash means that figure's source is briefly unavailable — store-wide numbers come from Shopify and update on a delay. Your Formtoro numbers still show. If the whole dashboard is empty, it just needs traffic. See Analytics.

My AI client won't connect

• Double-check you used the exact server URL https://mcp.formtoro.com/mcp.
• For Claude Desktop, restart the app after editing the config file.
• The client must prompt you to sign in to Formtoro and approve — complete that step. See AI access & API keys.

Still stuck?

If something looks wrong that isn't covered here, your changes may simply need a republish, or you may be testing as a visitor who doesn't match the form's audience. Re-checking those two things resolves most surprises.