Forms
Forms are added through markup in the editor. Submissions are stored by Micropage and viewable in the web app or CLI.
Adding a form
In the Edit tab, add a form block to your page markup:
form: Contact
input: Name*
input: Email*
textarea: Message
submit: Send
Save and publish for the form to become active. Add a success: line to replace the default confirmation message shown after a submission — see Success message.
How submissions work
When a visitor submits the form:
- The data is sent to the Micropage backend.
- The submission is stored against the project.
- It appears in the Form Submissions tab.
- Notification jobs run if configured (email on Pro/Pro+, webhook on Pro+).
No external service is required for basic submission storage.
If the Newsletter toggle is on for the form in Settings → Forms, the submission also creates a subscriber — see Newsletter.
Viewing submissions
Web app: open the Form Submissions tab. Submissions are listed with timestamp, page URL, and field data.
CLI:
micropage submissions list
micropage submissions show <id>
Spam protection
Forms include a hidden honeypot field and server-side validation: only fields defined in the form markup are accepted, and fields marked required in markup (label ending with *) must be non-empty on the server as well.
Published forms are also protected by Cloudflare Turnstile, and submissions are checked automatically for common spam patterns. Suspected spam goes to the Spam view in the Form Submissions tab instead of the inbox, without notifications or newsletter sign-ups. Use Not spam to move a submission back, or Mark as spam to flag one yourself. See Spam protection.
Notifications
| Plan | What you receive |
|---|---|
| Pro | Daily email digest |
| Pro+ | Instant email per submission + daily digest |
| Pro+ | Webhook POST to a URL you configure |
Configure the webhook URL in Settings → Forms. See Forms (concepts) for the payload format and header reference.
Limits and plan features
| Capability | Free | Pro | Pro+ |
|---|---|---|---|
| Submissions per project per month | 100 | 1,000 | 10,000 |
| CSV export | no | yes | yes |
| Daily email digest | no | yes | yes |
| Instant email per submission | no | no | yes |
| Webhook | no | no | yes |
Allowances apply per project, per calendar month (UTC) on every plan. Submissions flagged as spam don't count toward them.