Frequently Asked Questions

Common questions about Static Forms

Getting Started

How do I get started with Static Forms?

Getting started is simple:

  1. Sign up for a free account at the registration page
  2. Verify your email address
  3. Get your API key from the dashboard
  4. Add the form endpoint to your HTML form

See our Quick Start guide for detailed instructions.

Is there a free plan?

Yes! Static Forms offers a free plan with 500 email submissions per month. This is perfect for small websites and personal projects. No credit card required.

Do I need a backend server?

No! That's the whole point of Static Forms. You can use it with any static website hosting (GitHub Pages, Netlify, Vercel, etc.) without needing a backend server. The form submissions are handled by our API.

API Keys

Can I use multiple API keys?

Each account has one API key. If you need multiple keys for different projects, you can create multiple accounts or upgrade to Pro tier which supports child accounts with separate API keys.

Is my API key secure?

API keys are safe to use in client-side code (HTML forms, JavaScript). However, you should:

  • Keep your API key private
  • Don't commit it to public repositories
  • Regenerate it if you suspect it's compromised

Can I regenerate my API key?

Yes, you can regenerate your API key from your account settings. Note: You'll need to update all forms using the old key with the new one.

Rate Limits & Usage

What happens if I exceed my monthly limit?

If you exceed your monthly email limit, you'll receive a 429 status code. Your forms will still accept submissions, but emails won't be sent until:

  • The monthly limit resets
  • You upgrade to a higher tier

Limits reset monthly on a rolling basis. Check your dashboard for your current usage.

Are there per-minute rate limits?

Form submissions don't have per-minute rate limits - only monthly email limits apply. However, the ALTCHA challenge endpoint has a rate limit of 10 requests per minute per API key.

How do I check my current usage?

You can check your current usage and limits in your dashboard. The dashboard shows how many emails you've sent this month and when your limits reset.

Features

Can I customize email templates?

Yes! Pro tier users can customize auto-responder email templates with variables like {{name}}, {{email}}, and {{message}}.

Visit your Auto-Responders settings to configure templates.

Do you store form submissions?

Form submission storage is an optional Pro tier feature. By default, submissions are not stored. If you enable storage, submissions are retained for up to 12 months and can be viewed, exported, or deleted from your dashboard.

Can I use webhooks with the Free tier?

No, webhooks are a Pro tier feature. Free tier users receive email notifications only. Upgrade to Pro to enable webhook integrations.

What file types are supported for uploads?

Supported file formats include:

  • Documents: PDF, DOC, DOCX, TXT, RTF
  • Images: JPG, PNG, GIF, WEBP

Maximum file size: 5MB per file. File uploads require Pro tier.

Spam Protection

Do I need CAPTCHA?

While not required, we recommend using spam protection for public-facing forms. Static Forms supports:

  • Honeypot fields - Free, invisible spam protection
  • ALTCHA - Privacy-first CAPTCHA (Pro tier)
  • reCAPTCHA - Google's CAPTCHA service

Which CAPTCHA should I use?

We recommend ALTCHA for most use cases because it's privacy-focused, easy to set up, and provides a better user experience. reCAPTCHA is a good alternative if you prefer Google's service. See our Spam Protection guide for details.

Technical Questions

How do I handle form validation?

Static Forms accepts any form data you send. You can implement validation on the client side using HTML5 attributes or JavaScript:

<input type="email" name="email" required />
<input type="text" name="name" minlength="2" required />

Server-side validation is also performed for security.

Can I use AJAX instead of form submission?

Yes! Static Forms supports both traditional form submissions and AJAX requests. See our Advanced Features documentation for AJAX examples.

Do you support CORS?

Yes! Static Forms supports Cross-Origin Resource Sharing (CORS) by default. You can make requests from any domain without additional configuration.

What happens if my form submission fails?

If a submission fails, the API returns an error response with details:

{
  "success": false,
  "message": "Error description here"
}

Check our Troubleshooting guide for common errors and solutions.

Billing & Plans

Can I cancel anytime?

Yes! You can cancel your Pro subscription at any time. You'll continue to have access until the end of your billing period, then your account will revert to the free tier.

What payment methods do you accept?

We accept credit cards and debit cards through Stripe. The free plan requires no payment method.

Do you offer refunds?

Yes, we offer refunds within 30 days of purchase. Contact support for assistance with refunds.

Still Have Questions?

Can't find what you're looking for? Check out these resources: