Docs / Troubleshooting / Common Issues
Back to FastMode

Common Issues

Troubleshooting Common Issues

Site Not Loading

  • Check deployment status — Go to Settings to see if deploy succeeded
  • Verify manifest.json — Must be valid JSON with required fields
  • Check for errors — Look for error messages in the dashboard

Changes Not Appearing

  • Clear browser cache — Hard refresh with Ctrl/Cmd + Shift + R
  • Wait for propagation — Changes may take a few seconds
  • Check you saved — Ensure you clicked Save after editing

GitHub Deploy Not Working

  • Check webhook — Verify webhook is active in GitHub repo settings
  • Correct branch — Confirm you're pushing to the connected branch
  • Valid package — Ensure manifest.json is valid

Custom Domain Issues

  • DNS propagation — Can take up to 48 hours (usually minutes)
  • Correct records — Double-check CNAME points to your subdomain
  • SSL pending — Certificate provisioning may take a few minutes

Forms Not Submitting

  • Check data-form-name — Forms need this attribute
  • Include handler script — JavaScript must intercept form submit
  • Check console — Look for JavaScript errors

API Errors

  • 401 Unauthorized — Check API key is correct
  • 403 Forbidden — Verify tenant ID matches your project
  • 429 Rate Limited — Slow down requests

Zapier Not Triggering

  • Zap turned on? — Check the Zap is enabled
  • Correct project? — Verify you connected the right project
  • Re-test trigger — Refresh the field schema by testing again

Getting Help

If you're still stuck:

Built in Fast Mode