What is a Form?

A form in WidgetForm is a collection of fields that you configure to be displayed within a widget on your website. Once a form is created, it can be connected to a website. For details on configuring a website, see the Website Configuration page, and for form connection, refer to the Form Connection section.

Configuration

To configure a form, navigate to the Forms page and click the Add+ button.

Screenshot 2024-08-31 at 5.37.24 pm.png

Form Properties

Each form has the following properties:

Form Name

This property is used to identify forms on the forms list page. It is also displayed at the top of the widget (see the image) if multiple forms are connected to the same website.

widget-example.png

One-Time Use Form

If checked, this setting makes the form available for submission only once per user. When a user submits a one-time form, the information is stored on their device (in browser storage), and the form will no longer be visible to that user. Note: If the user changes browsers or clears their local storage, the form will become available again.

Manual Use Form

If checked, the form will not be displayed in the widget but can be opened using our JavaScript API. This is useful when you want forms to be opened manually via the API and do not want them visible to users in the widget.

Form Path Filter

If specified, this filter determines whether the form should be displayed in the widget based on the page's URL. This allows you to configure which forms are available to users on specific pages.