Documentation
Everything Vellform does, and the numbers behind it.
Every table on this page is generated from the same code the product runs on, so a documented figure and an enforced one cannot disagree.
Getting started
- Describe the form. On the Create page, write what you need, or pick a blueprint. Each blueprint is a full brief including the visual direction.
- Watch it build. The editor opens and the assistant works through it, streaming every step: which tool it called and with what.
- Adjust anything by hand. Every question, rule and theme token is editable directly. Editing by hand costs no credits.
- Publish and share. The form gets a public link. Responses land in your Inbox.
Field types
18 types are available on every plan.
| Type | What it is |
|---|---|
text | A single line of text. |
long_text | A paragraph. Can carry an optional AI follow-up question. |
email | An email address, validated. |
phone | A telephone number. |
number | A number, with optional bounds. |
url | A web address. |
date | A date. |
select | A dropdown of options. |
radio | One choice from a visible list. |
multiselect | Several choices from a list. |
checkbox | A single yes/no agreement. |
yes_no | A two-button yes or no. |
rating | Stars, hearts, thumbs or numbers, up to a configurable maximum. |
opinion_scale | A numbered scale with labelled endpoints. |
nps | A 0–10 recommendation score. |
file_upload | A file, stored privately. |
signature | A drawn signature, stored as an image. |
hidden | A value carried from the URL, never shown to the respondent. |
Themes and typography
A theme is a set of tokens — colours, fonts, corner radius, shadow, card style and a background treatment — resolved to CSS variables that the renderer paints from. Changing a token changes the form everywhere at once.
- Backgrounds can be a solid colour, a two-point gradient, a four-point mesh, a repeating pattern, or a photograph.
- 7 curated font pairings, or any family from the Google Fonts catalogue for headings and body separately.
- 12 complete presets for the brand kit, each a full palette and type treatment.
- A brand kit per workspace. Set your logo, palette and type once and every new form starts from it — the assistant is told those colours are deliberate and keeps them unless you ask for a different look.
Conditional logic
Rules show, hide or skip based on what somebody has answered. A rule has one or more conditions, combined with all or any, and an action. The assistant can write them from a description, and it reads the existing rules before it deletes a question so a rule is never left pointing at nothing.
Responses and exports
- The Inbox spans every form. Pick one form to compare answers in a table or read a single question across every response.
- Partial responses. Multi-page forms save as people go, so an abandoned form still shows what was answered and where they stopped.
- CSV export includes a signed link column for every file and signature. Those links last seven days, which the column header states.
Uploads and signatures
- File uploads are capped at 25 MB, and the form's author can set a lower limit per field.
- Signatures are capped at 1 MB — a few strokes of PNG — and that ceiling is fixed, so a signature field cannot be turned into a general file drop.
- Allowed types are an allow-list of documents and images. No archives, nothing executable.
- Files are stored privately. Opening one requires a signed link that only the form's owner can request, and it expires in five minutes.
How credits work
A credit measures AI work. Everything that is not AI work is free: opening the editor, editing by hand, publishing, collecting responses, exporting.
- Each plan includes a monthly allowance, from 25 on Free to 1100 on Premium.
- The allowance resets each billing period and does not carry over.
- You can buy a top-up of 250 credits for $18. Purchased credits sit on top of the allowance and survive the reset.
- At zero, AI requests stop. Your forms keep working and keep collecting responses.
- Settings → Credits lists every run and what it cost.
Plan allowances
Every plan includes the entire builder. What a paid plan buys is a larger allowance.
| Plan | Forms | AI credits | Responses | Storage |
|---|---|---|---|---|
| Free | 5 | 25 / month | 100 / month | 102 MB |
| Starter | 20 | 200 / month | 1,500 / month | 1 GB |
| Pro | 50 | 400 / month | 3,500 / month | 10 GB |
| Premium | 100 | 1100 / month | 10,000 / month | 100 GB |
Rate limits
These exist to stop a runaway script, not to pace normal use. Read the scope column: some are per address, some are per workspace.
| Action | Limit | Scope |
|---|---|---|
| Submitting a form | 40 / minute | Per IP address |
| Saving progress on a multi-page form | 30 / minute | Per IP address |
| View and start telemetry | 60 / minute | Per IP address |
| AI follow-up question on a form | 10 / minute, and 300 / hour | Per IP address, and per form |
| Uploading a brand asset | 30 / minute | Per workspace |
| AI editor runs | 120 / minute | Per IP address |
| AI editor runs | 20–60 / minute, by plan | Per workspace |
Integrations
Each submission can be delivered as it arrives.
| Destination | What it does | Status |
|---|---|---|
| The answers, emailed to you on submit | Available | |
| Webhooks | Signed JSON POST on every submission | Available |
| Slack | Post responses into a channel | Available |
| Discord | Post responses into a channel | Available |
| Google Sheets | Append a row per response | Available |
| HubSpot | Create or update a contact | Not built yet |
| Notion | Add a row to a database | Not built yet |
| Airtable | Append a record to a base | Not built yet |
Webhook deliveries are signed, so your endpoint can verify the request came from us. Delivery targets are restricted to an allow-list of hosts per integration.
What we haven't built
The most useful section on this page. If one of these matters to you, you should know before you subscribe rather than after.
- Custom domains. Forms are served from Vellform.
- A template marketplace. You can start from a blueprint, but there is no catalogue of templates other people have published.
- A published uptime commitment. We do not offer a service level agreement, so we do not advertise one.
- Security certification. We hold none and we claim none.
Recently built
These were on the list above until recently. They are listed here rather than quietly deleted, because a page that only ever grows shorter is not a record of anything.
- Team seats. Invite people by email from Settings → Team as an admin, editor or viewer. Seats are counted against your plan, and a pending invitation holds one.
- Email notifications. Set a notification address in a form's Integrations tab and every submission is emailed to you, with the same retry ladder and delivery log as a webhook.
- Removing the Vellform badge. Available on Pro and Premium, and enforced when the form is published rather than in the browser.
- Automatic deletion of old responses. Set a retention period per form. Nothing is deleted unless you choose one — the default is to keep everything.
- Undoing an account deletion. Deletion is now scheduled rather than immediate. Signing in within 30 days cancels it.
Questions this page does not answer belong on the support page.