> For the complete documentation index, see [llms.txt](https://docs.morpht.com/convivial-for-govcms/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.morpht.com/convivial-for-govcms/content-editing/webforms.md).

# Webforms

Webforms are the site's contact, feedback and application forms. They are built in the Webform module's own editor and placed on pages with a component.

## Building a form

*Manage → Webforms* (`/admin/webform`) lists every form. **Add webform** creates one; **Build** on an existing form opens the editor where you add elements (text fields, selects, file uploads, pages of a multi-step form), set validation, and under **Settings** configure the confirmation message and the email or other handlers that run on submit. The [Webform documentation on drupal.org](https://www.drupal.org/docs/contributed-modules/webform) covers the editor in depth.

![The webform list](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-febac2b853e580b5bef250ca23f09caf86984887%2Fwebforms.png?alt=media)

Webforms are generally excluded from site configuration, so changes made here take effect immediately and do not need a deployment.

## Placing a form on a page

Add an **Embedded Webform** component to the page and choose the form — see [Advanced components](/convivial-for-govcms/content-editing/components/advanced-components.md). A form can be placed on any number of pages.

See an embedded webform on the demo site: <https://govcms.convivial.io/demo/components/embedded-webform>

## Viewing submissions

*Manage → Webforms → Submissions* (`/admin/webform/submissions/manage`) lists all submissions across forms; each form's **Results** tab lists its own. Open a submission to see what was entered. Only [Submission viewers](/convivial-for-govcms/roles/submission-viewers.md) and [Webform managers](/convivial-for-govcms/roles/webform-managers.md) can see this.

![Webform submissions](https://3733701002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3fBWwpuJPUqPpT2ulMXp%2Fuploads%2Fgit-blob-b9888458590a03483bc23b3b365b724afc0307d7%2Fwebform-submissions.png?alt=media)
