In this article, we can describe how you can set up a form in WeGuide. This form can later be used as a survey (engagement type) for your participants so that they can collect data for your program.

What is a Form

A form is a set of questions or content that can be displayed across one or multiple screens. You can customise and edit these Forms to create a custom experience for your participants, and gather the specific data you need for your study or app. 

You can add multiple types of content to a Form, including questions, images, GIFs, videos and audio. Please see here for more information on how to create great content in WeGuide: WeGuide Content Guide. 

Importantly, remember to get into the system and play around yourself. We recommend using our interactive demonstration first, to get familiar:

How to Create a Form

In order to use create your own form, you will need to follow a few steps. Will explain them in detail underneath.

Step 1: Open the Forms page

• Click on the Forms icon to be taken to the form overview page. From here, you will be able to see existing forms and create new ones.

            Click on Forms to be taken to the Forms page

Step 2: Create a new form

• You will now see an overview of all the created forms. Click on + New Form to start setting up your form.

            Click on + New Form to start setting up your new form

Step 3: Start setting up your basic form details

You can now start setting up your form. Before you can add any questions, you need to set up the basic form details. In this section, we will describe each field in detail. You can find a screenshot of how it will look when you have filled in all the details.

• Title: This is the title of your form, as shown to the participant. This title will show up for the participant while they're completing the survey so make sure this title is meaningful. We recommend keeping it as short as possible
• Description: This is the description of your form. This is shown on the forms overview page and is used to explain to other portal users what the form is about. It is currently not being shown to the participants.
• Form ID: This is the ID that is being used for your Survey. This ID will be used for all business logic and references to this form, so it's important to pick a variable name that is meaningful to you. Don't make it too long, since otherwise, you have to do a lot of typing when writing conditional logic. This field can't be changed once you have saved your form once, so pick carefully.
• Calculation Type: If you want to calculate a score for your survey, you can switch this to Sum, Mean or Percentage. For each question, you will be able to specify the scoring. After each participant has completed a survey, the score will be calculated by means of the calculation type. So let's say the score is Sum and the participant has answered questions that have scoring logic of 2, 4 and 6, then their score will be 12. If the calculation type was Mean, then their score will be 4.
• Subtitle: Sometimes it's helpful to add a subtitle for your survey. This subtitle is used by admin users who want to leave a bit more details about their survey for other admin users. It is currently not shown to participants.
  
• Route to after completion: In case your white label app has a custom page, we can redirect the user to this page after they complete their survey. In the future, it will be possible to route users to every page in our application, if this is of interest to you, please reach out to us. 
• Supported languages. The forms that are built within the WeGuide system support multiple languages. So you can create the form in one language and then add translations for other languages. How this works in detail is described in a different article, but in this select field, you can decide which languages are supported in your form.
• Default language. This is the default language of the form. In case your participant is using our app in a language that is not supported for this form, then this default language will be used. 
• Shared or program-specific. You are able to create a form that is shared with all admin portal users, or you can assign a form to a specific program. If the form is assigned to a specific program, then only admin users who have edit program rights to that program will be able to see and edit the form. 
• Celebrate. If you want to show a celebration modal at the end of the form, then turn this on. You are now able to add HTML content that will be displayed in the celebration modal and you are able to turn confetti on or off (who doesn't want confetti??!). The modal will be displayed after the user has finished the form. The celebration modal will show like underneath:

Example of a celebration modal with confetti

• Allow instructions. If you want to instruct people on what is expected from them before they start the survey, you can add instructions to your survey. These instructions will show up before the user will start the survey and will provide them with the right information so that they can complete the survey in a good manner. The instruction will show like underneath:

Example of how instructions will show in WeGuide

• Show the question number in the progress bar. If you want to show the question number in the progress bar, then turn this on. If you would rather have it hidden, then disable it. 
• Variables. This functionality is in beta and is not fully supported yet. 

This is how your form details section will look once you have added data for all sections. 

Once you have added your form details, press "Save as draft". Your form will now be saved and you can start adding questions.

Step 4: Add your questions.  

• You can now start adding your questions. Click on the + Add Question button and start adding your questions, as shown underneath. In the rest of this section, we will explain the different question types and question attributes.
  

Click on add question to start adding questions to your survey. Hover over the individual icons to get a description of the question type

For more information on all of the different question types, please click here. Different Question Types in WeGuide Questionnaires 

Step 4: Save & Publish your survey 

To understand the different statuses of a form, check the interactive demonstration underneath, our read the description. 

Now that your survey is ready, it's time to save it. We have 3 different states where you can save it in.

• Draft mode. The survey is still editable, but can't be used in a program yet.
• Publish - Testing mode. The survey is still editable and can be tested inside a program.
• Publish - Production mode. The survey is no longer editable, only textual changes are allowed. The survey can be used in a program to collect data from now onwards

After you have published a survey to “production” mode, you won’t be able to change any fields anymore that might affect the data collection process. We have restricted this to ensure high-quality data. You won’t be able to add new questions, change the order or add options for example. The main changes that are allowed will be textual changes, such as typos. 

All the fields are locked by default, underneath the field or attribute that you can change:

Setup

• Description
• Subtitle
• Route to after completion
• Celebration content
  • Celebrate text. 
  • Confetti on/off
  • You won’t be able to turn on/off celebration content after publishing to production mode. 
• Instructions content
  • Instructions header
  • Instructions items (ability to add/edit/delete)
  • Instructions back button
  • Instructions next button
  • You won’t be able to turn on/off “Allow instructions” after publishing to production mode. 

Questions

• Question Title
• Subtitle
• Info text
• Footer
• Option text 
• Validation message
  • You won’t be able to add/edit/delete validations, you can only change the message that will be shown to users. 
• All labels
  • Data label
  • Minimum label
  • Maximum label
• Placeholder
• Instruction Description. 
• Photo/video recording instructions 
  • You won’t be able to turn on/off the instructions, you can only change the content of the recording instructions
• Photo/video instructions 
  • You won’t be able to turn on/off the instructions, you can only change the content of the instructions. 
• Verify recording question. 
  • You won’t be able to turn on/off the verify recording question, you can only change the content of the question.
    

Was the article missing some information or unclear? Please click on the thumbs down below and let us know how we can improve. Your feedback is always appreciated.