Page Comparison

Instructions on Read our instructions for how to create and build a webform in the Drupal CMS , as well as add it to a web page, manage your submissions and archive your form.

Request a new form

If you'd like to build a new form in the webpage.

There are some limitations with our Drupal webforms settings – not every field and option that you can see in the CMS back-end is currently set up. Advanced guidance detailing these limitations will be available soon.

On this page:

...

...

Create a new form

• Go to the main top ribbon in the CMS and select Structure and then Webforms.

• Select the +Add webform button.

• Add a title for your form.

• Fill in the administrative description with information that will be useful for your team, such as the purpose of the form and where it will be embedded.

  • If you’re building the form in content.vic.gov.au, please copy and paste the below and fill it in:

    • Form contact:

    • Department or agency: 

    • Embedded on page: [Add the URL of the

    page where the form will be embedded

    • webpage]

    • Submissions to: [The email address that submissions will be sent to, if setting up email notifications.]

    • Data export plan: Data is exported [choose either weekly, fortnightly or monthly] by [person responsible] and then deleted from the CMS. 

    • Tested by: [Leave blank – this will be completed after you submit your form for testing.]

    • Description: [Purpose of your form]

• Click save.

Build your form

• Go to the Build tab.

• Add your form fields by selecting +Add elements and choosing from the range of form elements available. For more information on each of the form elements, hover your mouse over the question mark next to each one.

• For each form field/element:

  • The General tab allows you to add in a title, description text, any options for elements such as radio buttons, set the field to be “required” (make it mandatory to be filled in by the user) and add character or word count limits.

  • The Conditions tab allows you to add basic conditional logic to your form, such as making the field visible or hidden depending on the answer given in an earlier field.

Customise your form settings

Confirmation settings

• Go to the Settings tab (next to the Build tab) and click on the Confirmation tab below tab for “Confirmation”.

• In the first “Confirmation type” Confirmation type section, change this setting to “Inline” – this will make the form disappear from the page once the user has submitted it and display the confirmation , and replace it with a successful submission message.

  • Choosing We recommend choosing this setting as it will mean users can’t submit prevent users from submitting multiple duplicate copies of the form and have more confidence that their submission has been saved. If you would like to accidentally, and makes the successful submission message more obvious.

  • The default setting of “Page” will keep the form visible and filled in on the same page after the user clicks Submit, but will also display the confirmation message at the top of the form. This can be easy for the user to miss if your form is long.

  • No other options in this section are currently configured.

• To customise the confirmation message that displays,

  this can be done in

  go the

  next field below: “Confirmation settings”. Please note: the

  field below labelled Confirmation settings.

  • If left blank, the default confirmation message is “Thank you! Your response has been submitted.”

  • Webform tokens (e.g. displaying the submission ID number) aren’t currently configured to work on the front-end display.

  • The field “Confirmation page/modal title” is not currently supported, so just fill in the “Confirmation message” field only.

Email notification settings

• You can set up options to email copies of the form submissions to specific email addresses. This can be found under the Settings tab > Emails / Handlers tab. 

  • The From email address can't be changed Leave the Title field as is.

  • Change the To email option to either:

    • “Custom To email address” – for an internal VPS email address where you’d like to collect the submissions

    • An email address field that is in the form – to send confirmation messages to the user who filled in the form.

  • You can choose whether any other email addresses are CCed or BCCed in the emails as well.

  • Do not change the From email address – this must remain as the default [site: mail] option otherwise the emails either won't send. The email address that will appear as the sender is “noreply@dpc.vic.gov.au”.

    • You can add a custom “From name” to display as the sender of the email though.

    • You can also set up a custom Reply-to email.

View and test your form

There are some discrepancies between how the form displays in the View or

...

Test tab of the CMS and how it displays when embedded on a webpage.

The best option for checking and testing your form is to embed it on a page in Draft status – you will be able to see and interact with the form without needing to publish the page.

Embed your form on a webpage

1. In the edit screen of your page, click the Add Component button and select 'Form embed (Drupal)'.

2. In the title field you can either add a heading for this form (it will display as a Heading 2 size) or you can leave this field blank.

3. In the webform dropdown, scroll to find the name of the form you want to embed. The names displayed on this list are internal names and won't show on the page.

\uD83D\uDCCB Related articles