Forms 2

content/collections/fieldtypes/form.md

@@ -22,7 +22,7 @@ options:
     name: query_scopes
     type: string
     description: >
-      Allows you to specify a [query scope](/extending/query-scopes-and-filters#scopes) which should be applied when retrieving selectable assets. You should specify the query scope's handle, which is usually the name of the class in snake case. For example: `MyAwesomeScope` would be `my_awesome_scope`.
+      Allows you to specify a [query scope](/extending/query-scopes-and-filters#scopes) which should be applied when retrieving selectable forms. You should specify the query scope's handle, which is usually the name of the class in snake case. For example: `MyAwesomeScope` would be `my_awesome_scope`.
 related_entries:
   - fdb45b84-3568-437d-84f7-e3c93b6da3e6
   - aa96fcf1-510c-404b-9b63-cea8942e1bf8
@@ -31,6 +31,8 @@ related_entries:
 
 The Form fieldtype is gives your users a way to pick a form to include along with the current entry. How that form is implemented or shows up on the page is up to you.
 
+Not to be confused with [form fieldtypes](/forms#form-fieldtypes) — the fields you add _inside_ a form when building it. This fieldtype is for selecting an entire form from elsewhere, like an entry.
+
 ## Data Storage
 
 The Form fieldtype stores the `handle` of a single form as a string, or an array of handles if `max_items` is greater than 1.
@@ -45,4 +47,20 @@ The Form fieldtype provides a few useful variables:
 * `api_url`
 * `honeypot`
 
-You can use the [`form:create`](/tags/form-create) tag to render a `<form>` on your page.
+You can pass the `handle` to the [`{{ form:create }}`](/tags/form-create) tag to render a `<form>` on your page:
+
+::tabs
+
+::tab antlers
+```antlers
+{{ form:create :in="form_fieldtype:handle" }}
+    ...
+{{ /form:create }}
+```
+::tab blade
+```blade
+<s:form:create :in="$form_fieldtype->handle">
+    ...
+</s:form:create>
+```
+::

content/collections/pages/conditional-fields.md

@@ -382,4 +382,4 @@ For more advanced conditional validation, take a look at Laravel's `required_if`
 
 ## Templating
 
-You can take advantage of Conditional Fields on your front-end Forms to automatically generate dynamic forms and logic. [Learn more about it](/tags/form-create#conditional-fields).
+You can take advantage of Conditional Fields on your front-end Forms to automatically generate dynamic forms and logic. [Learn more about it](/tags/form-create#logic-conditional-fields).

content/collections/pages/events.md

@@ -552,6 +552,18 @@ public function handle(FormBlueprintFound $event)
 }
 ```
 
+### FormCreated
+`Statamic\Events\FormCreated`
+
+Dispatched after a form has been created.
+
+``` php
+public function handle(FormCreated $event)
+{
+    $event->form;
+}
+```
+
 ### FormCreating
 `Statamic\Events\FormCreating`
 
@@ -1131,7 +1143,7 @@ public function handle(StaticCacheCleared $event)
 ### SubmissionCreated
 `Statamic\Events\SubmissionCreated`
 
-Dispatched after a form submission has been created. This happens after a form has been submitted on the front-end.
+Dispatched after a form submission (including [partial submissions](/repositories/form-submission-repository#partial-submissions)) has been created. This happens after a form has been submitted on the front-end.
 
 ``` php
 public function handle(SubmissionCreated $event)
@@ -1145,7 +1157,7 @@ If you're looking to prevent a form being submitted or trigger validation errors
 ### SubmissionCreating
 `Statamic\Events\SubmissionCreating`
 
-Dispatched before a submission is created. You can return `false` to prevent it from being created.
+Dispatched before a submission (including [partial submissions](/repositories/form-submission-repository#partial-submissions)) is created. You can return `false` to prevent it from being created.
 
 ``` php
 public function handle(SubmissionCreating $event)
@@ -1154,6 +1166,20 @@ public function handle(SubmissionCreating $event)
 }
 ```
 
+### SubmissionFinalized
+`Statamic\Events\SubmissionFinalized`
+
+Dispatched when a submission is finalized — either when a regular form is submitted, or when the final page of a multi-page form is submitted and its [partial submission](/repositories/form-submission-repository#partial-submissions) becomes complete.
+
+Unlike `SubmissionCreated`, this event never fires for partial submissions, making it the best place to hook in logic that should only run once a submission is truly complete.
+
+``` php
+public function handle(SubmissionFinalized $event)
+{
+    $event->submission;
+}
+```
+
 ### SubmissionDeleted
 `Statamic\Events\SubmissionDeleted`