Submissions
Submissions are the saved records created when someone interacts with a Formie form.
They can represent a completed submission, a partially saved draft, or a submission that has been marked as spam. Once a submission exists, you can review it in the control panel, organize it with statuses, export its data, relate it to other elements, or render it back into the front end for editing.
Submission states
Formie tracks a few built-in submission states:
- complete submissions have finished the normal submission flow
- incomplete submissions are partially saved, such as save-and-continue drafts or multi-page progress
- spam submissions have been screened and marked as spam
These are system states. They describe what happened during submission processing.
Custom Statuses are different. A status is your team's workflow label on top of the saved submission, such as new, approved, or closed.
Common ways to work with submissions
Organize them with statuses
Use Statuses when your team needs labels for review, follow-up, or internal processing after a submission has been saved.
Export submission data
Use Exporting when you need spreadsheets, reporting output, or a portable snapshot of saved submission data.
Relate submissions to other elements
Use Relations when a submission belongs to another Craft element such as an entry or product, or when you want to look up related submissions later.
Select submissions from other elements
Use Element Field when you want another Craft element to choose and store a reference to a Formie submission.
Let users edit saved submissions
If you need to render an existing submission back into the front end so a user can update it, see Editing Submissions.
Developer access
If you are working with submissions in templates or custom code:
- use Submission Queries to fetch submissions in Twig or PHP
- use Submission Workflow when you need to hook into submission processing stages or tasks
- use Submission Content when you need the right value format for output, exports, summaries, emails, or integrations
- use Submission for the public properties and methods available on the element itself