# Forms

## What are Forms?

At a fundamental level, a form is any structured request for data.

In the Form.io Platform, forms are the fundamental user element. Forms collect, validate, and structure data. The same structure automatically defines a backend API to manage and access submitted data.&#x20;

## Overview of Forms

<table data-view="cards"><thead><tr><th align="center"></th><th></th><th data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td align="center">Building Forms</td><td>Forms are built with a drag-and-drop Form Builder.</td><td><a href="forms/form-building">form-building</a></td><td><a href="https://3305536326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPHoF2HwOA0s5HV_AIB%2Fuploads%2FaSr0AaQl08OZQaHhZ95h%2FraceFormBuilder2.png?alt=media&#x26;token=91cc02dd-305a-4dac-9a98-e9206fd153c3">raceFormBuilder2.png</a></td></tr><tr><td align="center">Types of Forms</td><td>Forms may be created as web forms, wizards, or fillable PDFs.</td><td><a href="forms/form-types">form-types</a></td><td><a href="https://3305536326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPHoF2HwOA0s5HV_AIB%2Fuploads%2FXK8l9n8wI9cX6W7rqW1H%2Fformcreation2.jpg?alt=media&#x26;token=121749dc-6785-4f55-917e-e8d011abd3b0">formcreation2.jpg</a></td></tr><tr><td align="center">Form Lifecycle</td><td>The typical workflow of a form in the Form.io Platform.</td><td><a href="forms/form-lifecycle">form-lifecycle</a></td><td></td></tr><tr><td align="center">Embedding a Form</td><td>How a form is used within an application.</td><td><a href="forms/embedding">embedding</a></td><td><a href="https://3305536326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPHoF2HwOA0s5HV_AIB%2Fuploads%2FXYBVXqnIuxsjd9AKTB6Q%2Fembedurl.jpg?alt=media&#x26;token=1c35feff-ab87-4d3e-98f0-eadab0f3d54a">embedurl.jpg</a></td></tr><tr><td align="center">Form Settings</td><td>Configure and customize a form.</td><td><a href="forms/form-settings">form-settings</a></td><td><a href="https://3305536326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPHoF2HwOA0s5HV_AIB%2Fuploads%2FD0DRZqB1n371oQLM3KHT%2Fsettingtabs.jpg?alt=media&#x26;token=d45c9e8e-5578-40cb-951f-1632a2aef9cc">settingtabs.jpg</a></td></tr><tr><td align="center">Form Revisions</td><td>Track changes to a form.</td><td><a href="forms/form-revisions">form-revisions</a></td><td><a href="https://3305536326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPHoF2HwOA0s5HV_AIB%2Fuploads%2FhGyGlWlawisChXTSFTxU%2Fforms%20revisionnote.png?alt=media&#x26;token=72b2fd67-f18f-4cd3-90a6-60f54ea2a97e">forms revisionnote.png</a></td></tr><tr><td align="center">Using Forms</td><td>How end users interact with a form.</td><td><a href="submissions">submissions</a></td><td><a href="https://3305536326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPHoF2HwOA0s5HV_AIB%2Fuploads%2FZNveDd1Xv9lgp1WZ3YBS%2Fformbuilding1.png?alt=media&#x26;token=fefece65-7bbc-40cd-bfd2-c4498bcef7a6">formbuilding1.png</a></td></tr><tr><td align="center">Form JSON</td><td>Understanding Form JSON</td><td><a href="forms/form-building/form-json">form-json</a></td><td></td></tr></tbody></table>

## **Form Lifecycle**

The typical Form creation process and life cycle can look like the following:

1. Form Creation
2. Adding Form Components
3. Adding Actions
4. Setting Up Roles and Permissions
5. Managing Submission Data

## Form Builder in Action

A live demo of the Form.io Form Builder is available at <https://formio.github.io/formio.js/app/builder>

This provides a glimpse into how the Form.io Platform uses components to create a Form and the JSON schema that defines it.&#x20;

[**Click Here**](https://help.form.io/master/overview#forms-and-resources) for an in-depth explanation of how Forms and Resources work.

<figure><img src="https://3305536326-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPHoF2HwOA0s5HV_AIB%2Fuploads%2FRraKcvjqRdyQlx3tub85%2Fform1.jpg?alt=media&#x26;token=50eebf97-e39f-4d57-b18b-9c34fdd35298" alt=""><figcaption></figcaption></figure>

## Form Embedding

Embedding places the live form in an application. This makes it accessible to the end user.

The Form JSON is rendered by the form renderer, which is built into the application. As a result, embedded a form is as simple as providing the hosted Form JSON to the Form Renderer.

For detailed information about embedding a form, refer to the [embedding](https://help.form.io/userguide/forms/embedding "mention")section of the Forms topic in the User Guide.

## Using A Form

When a form is completed by the end user, it creates a Submission. This submission records the data entered into the form, as well as some metadata about the user submitting the form.

For detailed information about submissions, refer to the [submissions](https://help.form.io/userguide/submissions "mention") section of the User Guide.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.form.io/userguide/forms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
