FAQs & Troubleshooting

Quick answers to the most common questions about Spectre Form Builder, plus fixes for issues you might run into.

Frequently asked questions

How do I add a form to my store?

The easiest way is with the Theme App Block. No code required.

1. Enable the Spectre Forms app embed in Online Store → Themes → Customize → App embeds
2. On the page where you want the form, click Add block and choose Spectre Form
3. Select your form and click Save

For more options (web components, modal buttons), see Embedding & Styling.

Why isn't my form showing on the storefront?

Check these things in order:

1. Form status — The form must be set to Published. Draft forms are hidden from visitors. Toggle status in the Form Builder header or in Form Settings.
2. App embed — The Spectre Forms app embed must be turned on in your theme. Go to Online Store → Themes → Customize → App embeds and confirm it's enabled.
3. Theme block — If you're using the theme block, make sure you selected the correct form in the block settings.
4. Published theme — Changes in the theme editor only go live when you save and publish the theme.

Can I use the same form on multiple pages?

Yes. Once a form is published, you can add it to as many pages as you like — either by placing the Spectre Form block on each page in the theme editor, or by pasting the <spectre-form> embed code wherever you need it. All submissions go to the same form regardless of where it's placed.

How do I change the language of my form?

The form automatically detects your store's active locale and shows the matching version. To set up additional languages:

1. Open the form in the Form Builder
2. Use the language switcher to add a new version
3. Edit labels, placeholders, and options for that language
4. Save

If the visitor's locale doesn't match any version, the default language is used. See Settings & Configuration for details.

What file types can customers upload?

The File Upload field accepts images: JPEG, PNG, GIF, and WebP. Maximum file size depends on your plan — 10 MB on Free, 30 MB on Starter, 100 MB on Pro. See Plans & Pricing for full limits.

How do I export my submissions?

1. Go to Submissions (all forms or a specific form)
2. Use filters and search to narrow the list if needed
3. Click Export and choose CSV or JSON

The export includes all submissions matching your current filters. See Submissions & Exports for more.

Can I connect my form to multiple integrations at once?

Yes. You can enable several integrations on the same form — for example, email notifications, Klaviyo, and Google Sheets all at once. Each submission triggers every enabled integration. See Integrations for setup details.

What happens when I hit my monthly submission limit?

New submissions are blocked until the next billing period or until you upgrade to a higher plan. You can check your current usage in the app. Upgrading takes effect immediately, so you won't miss submissions for long.

How do I cancel or change my plan?

Plan changes are managed through Shopify billing.

1. In the app, go to Plans or Billing
2. Choose the plan you want (or cancel)
3. Shopify handles the billing change on your next cycle

See Plans & Pricing for details on what each plan includes.

Troubleshooting

Form loads but fields are missing or unstyled

• App embed not enabled — The CSS and JavaScript that render form fields come from the app embed. Go to Online Store → Themes → Customize → App embeds and make sure Spectre Forms is turned on.
• Browser cache — Try a hard refresh (Ctrl+Shift+R or Cmd+Shift+R) or open the page in an incognito window.
• Custom CSS conflict — If you've added custom CSS (via the app embed or Form Settings), check for styles that might hide or reposition elements.

Submissions aren't arriving

1. Confirm the form status is Published
2. Submit a test response yourself and check the Submissions page in the app
3. If using integrations (email, Klaviyo, etc.), check that the integration is configured and saved — a missing API key or wrong webhook URL will silently fail
4. If you're over your monthly submission limit, submissions are blocked. Check your usage in the app.

reCAPTCHA isn't working

• Make sure both the Site key and Secret key are entered in Form Settings → Spam protection
• The keys must be for reCAPTCHA v2 (checkbox). v3 keys are not compatible.
• If you're testing on localhost or a non-public domain, add that domain to the allowed domains list in the Google reCAPTCHA admin.

File uploads fail

• Check the file type — only JPEG, PNG, GIF, and WebP are accepted.
• Check the file size — it must be under the max for your plan (10 MB / 30 MB / 100 MB).
• Check your total storage — if storage is full, new uploads are rejected. Delete old submissions or upgrade your plan.

Email notifications not sending

1. In Form Settings, confirm Email notifications is turned on
2. Check the Recipients field — at least one valid email address is required
3. Look in your spam or junk folder, as notification emails can sometimes be filtered
4. If using placeholders in the subject or template, make sure the field names match your actual form fields

Integration data not syncing (Klaviyo, MailChimp, HubSpot, etc.)

• Double-check the API key — a typo or expired key will cause silent failures
• Confirm the list or audience is selected and still exists in the external service
• Check field mapping — unmapped fields are not sent to the integration
• Some integrations (Google Sheets) require a connector to be set up first in the Connectors section of the app

Form looks different on mobile

The form components are responsive by default, but custom CSS or certain theme styles can interfere. If the layout breaks on mobile:

• Test with the Default style template to rule out custom CSS issues
• Use your browser's device emulation tool to inspect the layout
• Avoid fixed widths on form fields — use percentages or the built-in width settings

Note: If your issue isn't listed here, contact us at support@spectreapps.io and include the form name, your store URL, and a description of the problem.