Skip to content Skip to footer navigation
Light theme Dark theme

Form-submission Tag

If you want to show the user the data they submitted — whether as a confirmation or to pre-populate or personalize some content — this is the easiest way to do it.

Example

Here we'll output a small thank-you note once there's a successful submission, otherwise show the form itself.

The {{ name }} and {{ rating }} variables correspond to input fields of the same name.

{{ form:set is="feedback" }}
    {{ if {form:success} }}
 
        {{ form:submission }}
            Thanks for your feedback, {{ name }}.
            We appreciate the {{ rating }} star rating you gave us.
        {{ /form:submission }}
 
    {{ else }}
 
        {{ form:create }} ... {{ /form:create }}
 
    {{ /if }}
{{ /form:set }}

The {{ $submission['name'] }} and {{ $submission['rating'] }} variables correspond to input fields of the same name.

<s:form:set
  is="feedback"
>
  @if (Statamic::tag('form:success')->in('feedback')->fetch())
    <s:form:submission
      as="submission"
    >
      Thanks for your feedback, {{ $submission['name'] }}.
      We appreciate the {{ $submission['rating'] }} star rating you gave us.
    </s:form:submission>
  @else
    <s:form:create>
      ...
    </s:form:create>
  @endif
</s:form:set>
Hot Tip!

The $success variable is added by the <s:form:set></s:form:set> tag pair. It is a shortcut for the following:

@if (Statamic::tag('form:success')->in('feedback')->fetch())
  ...
@endif
A troll pointing a teaching stick

Parameters

handle|is|in|form|formset

string

Specify the name of the form. Only required if you do not use the form:set tag, or don't have a form defined in the current context.

Variables

Variable Type Description

submission data

 array

All the fields that were entered in the submission are available.