Submissions inbox
Everything the FormDB submissions inbox can do: Inbox, Spam and Trash folders, search, read state, delete and restore, and CSV or JSON export.
This page describes the submissions inbox: where your form's submissions appear, how to search and organise them, and how to export them as CSV or JSON.
Open the inbox
Go to Forms in the sidebar, click a form, and stay on the Submissions tab. Each form has its own inbox.
The Dashboard also has a Latest submissions card with the newest submissions from all forms. Clicking one opens it in its form's inbox.
Folders
Folder | Contains |
|---|---|
Inbox | Accepted submissions. The badge shows how many are unread. |
Spam | Submissions flagged by the spam filter, or marked as spam by you. |
Trash | Deleted submissions. They are removed permanently after 30 days. |
The table
Submissions are listed newest first, 25 per page.
- The table shows up to three fields as columns, followed by Received. If you defined fields in the form builder, the first three non-file fields are used. Otherwise the first three field names found are used.
- Unread submissions are shown in bold with a dot.
- A paperclip icon means the submission has files.
- A Paid badge means a Stripe payment was completed for it. See Stripe.
Open a submission
Click a row to open the submission in a side panel. Opening a submission marks it as read. The panel shows:
- Every field and its value. Email addresses and web links are clickable.
- Files, with name, size and type. Click a file to open it in a new tab. See File uploads.
- Stripe payment status, amount and customer, when there is a payment.
- Details: location, IP address, the page the form was on, browser, the submission ID, and spam signals when it was flagged.
Buttons at the bottom of the panel:
- Copy JSON copies the field values as JSON.
- Spam or Not spam moves it between Inbox and Spam (admins and owners).
- Delete moves it to Trash (admins and owners).
- Restore appears for submissions in Trash (admins and owners).
Each submission has its own address, which you can bookmark or share with a teammate. The notification email's View in FormDB button uses it.
Search
Type in Search submissions to filter the current folder. Search is not case-sensitive and looks for your text anywhere in the submission's data. It matches values and also field names, so searching for email finds every submission that has an email field.
Search covers one form and one folder at a time. There is no filter by date or by individual field.
Select several submissions
Tick the checkbox on each row, or the checkbox in the header to select the whole page. A bar appears with the actions for the current folder.
Folder | Action | What it does | Who can use it |
|---|---|---|---|
Inbox, Spam | Mark read | Removes the unread styling | Everyone |
Inbox, Spam | Mark unread | Shows the submission as unread again | Everyone |
Inbox | Spam | Moves to the Spam folder | Everyone |
Spam | Not spam | Moves to the Inbox | Everyone |
Inbox, Spam | Delete | Moves to Trash, without a confirmation | Admins and owners |
Trash | Restore | Moves back out of Trash | Admins and owners |
Trash | Delete forever | Permanently deletes the submission and its files, after a confirmation | Admins and owners |
Things to know:
- Not spam does not send the notification email or run integrations for that submission after the fact.
- Delete is reversible for 30 days. Delete forever cannot be undone.
- A submission can only be deleted permanently from the Trash.
Trash and restore
Deleted submissions stay in Trash for 30 days. During that time an admin or owner can select them and click Restore. After 30 days they are deleted permanently together with their files.
On the Free plan, submissions older than 30 days are hidden automatically. They can be brought back by upgrading within a year. See Data retention.
Export to CSV or JSON
CSV is a plain-text spreadsheet format that opens in Excel, Google Sheets, Numbers and most other tools. JSON suits code and other tools that read structured data.
- Open the folder you want to export. To export a subset, type a search first.
- Click Export, then choose CSV (spreadsheet) or JSON.
The export contains everything in the current folder that matches the current search, not only the page you are looking at and not only the rows you ticked. Any member of the workspace can export.
What is in a CSV file:
- One row per submission, newest first, up to 50,000 rows.
- Columns:
id,submitted_at(date and time in UTC), your builder fields in builder order, any other fields found in the submissions, thencountryandreferer. - File fields contain file names, not links or the files themselves.
- Fields with several values are joined with
;. - The file is named after the form, for example
contact-form-submissions.csv.
Values that start with =, +, - or @ are prefixed with a single quote. This stops spreadsheet programs from running a submitted value as a formula.
There are no scheduled exports and no bulk download of files. To fetch submissions from your own code, use the REST API on paid plans.
Other ways to get submissions out
- Email notifications for each new submission.
- Webhooks to send each submission to your own server.
- Google Sheets, Notion and Airtable integrations.
- The REST API, with workspace API keys, on paid plans. Its OpenAPI spec is at
https://api.formdb.io/v1/openapi.json.
What the inbox does not do
Submissions cannot be edited. There are no notes, tags, stars or assignments, and you cannot reply to a submitter from inside the dashboard. To reply, use your email: when the form has a field named email, replying to the notification email goes to the submitter.
Next steps
- Data retention: how long submissions are kept.
- Email notifications: get emailed for each submission.
- Workspaces and teams: what each role can do.
Ready to try it? Create a free account and send your first submission.