Surveys vs. Standard Forms
Creating a New Survey - Basic Information
Creating a New Survey - Form Settings
Creating New Survey Pages - Form Builder
Neon Fields vs. Toolbox Fields
Adding Suggested Giving Amounts to a Survey
Publishing a Survey
Setting the Form Acknowledgement Email & Web Template
Editing a Survey
Viewing & Exporting Survey Results
There are two kinds of forms in NeonCRM:
- Standard Forms are generated for you "out of the box," such as a Standard Donation Form and Email Subscription Form.
- Surveys allow you to collect different types of data than the Standard Forms. Surveys can be used for customized donation and membership forms as well as surveys, such as a client satisfaction survey.
You must have the Surveys & Surveys module in order to create surveys in NeonCRM. Your list of available modules can be viewed from the Organization Profile.
To create a new form or configure existing ones, navigate to Forms & Pages > Surveys.
This will take you to the Surveys List. Click the form name to access the settings of an existing form and to view any existing entries.
To create a new form, click New Survey.
Selecting the New Survey button will bring up the Survey Builder where you configure the Basic Information for your new form.
The Survey Builder contains several important settings:
The internal name of your form; this will not be seen by your constituents.
The internal description of this form.
This option allows you to collect Donation and Membership transactions via this survey. If you create a custom membership registration or donation form, Neon will use your standard Credit Card form to collect payment - this is the same payment page used for all your standard Neon forms and it can be configured using the web form customization utility.
There are two types of transactions that can be collected via a survey:
- Donation (free input donation amount OR donation levels).
- Membership (Join transactions for individual, No Group memberships only)
If you do not wish to collect payment for this form - for example, this is simply a contact application or other form collecting data - leave the value as "No Payment Support".
This option determines if the system will create individual accounts for each person who completes this survey.
- If you select Yes for the Create Account setting, then Neon will automatically create a new individual account for each person that submits this form. The Account Match & Queue will check for an existing account.
- If you select No, then your form will simply collect the information but Neon will not create an account for each entry.
This setting will make the Survey the default donation page which constituents will see under the "My Donation" area of the Constituent Login Portal.
This option will only be available if you choose Donation Free Input or Define Donation Level for the Support Payment option.
The form will be available through this date. For example, if you set the Valid Until date to 12/31/2020, the form will expire at midnight Central Time on 01/01/2020. If someone tries to access the form after this date, they will receive a notice that the page has expired: "Sorry! The form you are trying to access is not available."
This determines who will be able to view and complete the survey. A full explanation of these options is available in the Constituent Restricted Surveys guide.
This will only appear if your form is restricted to constituents/members/applicable group. This can be useful for collecting votes, or other applications that are only allowed one submission.
This is what constituents will see when they complete your form. If the survey is collecting payment (Donations or Memberships), this page will not apply. NeonCRM will instead use the default exit page for donation and membership transactions, which thanks the constituent for their donation or membership registration.
Enter an external URL will allow you to redirect the constituent to a URL of your choice upon completion of the form/survey.
Copy a staff user on the Form Acknowledgement Email when it is sent to the constituent. You must enable the form acknowledgement email. This will BCC the email addresses in this box with the Form Acknowledgement Email. More information on the Survey Acknowledgement Email is available here. When you have completed the basic settings for your survey, click Next to begin creating your survey.
Once you have filled out the basic information for your survey, you can create the content of the form itself. Under the Pages section, click New Page to start from scratch with a blank page or click Copy Page to use a page you've already created from another survey.
Clicking New Page will open the form builder to a blank page.
This will bring up the Survey Builder interface where you create the content of your form.
The Survey Builder will only pre-load two items for you, both of which are required for all surveys:
- Survey Header
- Submit button
You must add any other fields that you wish to collect data for. There are two types of data that you can collect: Neon Fields and Toolbox Fields.
Neon Fields link directly to NeonCRM fields, both Standard Fields (e.g. City, First Name, and Last Name) and Account Custom Fields, if you have any. Data entered into these fields will feed directly into NeonCRM accounts.
You will need to un-publish and remove those fields then re-add them. When you do this, you will notice that this field is no longer available under the Statistics Report section of the survey configuration page. The data was not lost, it just won't be shown under the survey stats. Or you can create a new survey and use the Copy Page function to copy an existing page over to a new form.
If your form is set up to create accounts, make sure to add the "First Name" and "Last Name" fields to your form page and set them as required.
Click on the field to access the Properties box. Use the Required drop-down to select "yes."
You can see that the field is now set as required.
Toolbox Fields are fields that you create solely for this form. These fields are not created as fields elsewhere in the NeonCRM system. The only way to view responses to these fields is to view survey results.
To add a field, drag and drop it between the Your Survey/Form Header and Submit items.
When you add a field and then select it, the Properties area in the left panel will populate with options for this field.
For example, we might change the Label of this field to Committee. It won't change the name of the field itself; it will only change how it's displayed on the form. We can also make the field required, change the size of the text box, change the maximum number of characters allowed in responses, and decide if this response will be included in the survey acknowledgment email.
There is also a Token Name field in the Properties section. The acknowledgment email that you can build for your surveys can include tokens for any fields in the form, including custom fields. The Token Name property allows you to name the available tokens for this email.
If left blank, the token will have the same name as the field.
If you attempt to give the token a name that is already in use, you will receive an error message and be asked to choose a different name.
Some fields will give you additional Properties options.
For example, in the screenshot above, I have added a Toolbox Field type called Check Box Text. This allows me to build out a question with a series of checkbox options, so my constituents can select more than one. I can create my options in the Properties area and then click the green checkbox to save my changes.
You can preview your survey at any time by select Preview.
Once you are satisfied with your survey, click Save to save your changes, then Home to return to the Survey/Form page.
Adding Suggested Giving Amounts to a Survey
If you select Suggested Donation Amounts when building a custom donation form, you'll have an added step when creating your form.
In the NEON FIELDS section, select Suggested Donation Amounts by dragging and dropping it onto your form.
The suggested amounts will initially look like this:
To edit the amounts, highlight the Suggested Donation Amounts field by clicking on it. The Properties area will appear on the left side of the screen. Click within the Options section to edit.
Once you do that, you'll start adjusting the labels for each level and their associated value. The syntax goes like this:
Label == amount
So, if you wanted a 25 dollar value to carry over to your credit card page and you'd want it to be labeled "$25 - Bronze Level", type:
$25 - Bronze Level == 25
Once you have completed your donation level setup, click the icon with the white paper and green checkmark to save.
Click Save at the top of the page to save your survey.
To generate a hyperlink for your survey, click Publish in the upper-right corner.
The Survey Link will display at the bottom of the Basic Information section.
Click Check to view your form. Your donation levels will display as configured.
Once you are ready to share your survey and allow constituents to begin taking it, you need to publish it. To do this, select [Publish] in the upper-right corner of the Survey page.
Survey Link - Upon publishing a survey, Neon will generate a link to your form.
Click Check to view your form. This is the link that you can share with your constituents and link to your website.
You can use the code snippet to embed the form on your own web page.
You can set your own acknowledgement email for your survey by going to the Survey detail page.
You can use a theme for this survey if you've created one. To change the theme, the form must be unpublished.
Click [New Template] to see a list of your available alternate web templates and select the one you want to use for this survey.
If you need to make changes to your survey, go to Forms & Pages > Surveys, then click on the survey that you wish to edit.
- If you remove any standard fields or account custom fields from a survey page, you will notice that this field is no longer available under the Statistics Report section of the survey configuration page. The data was not lost, it just won't be shown under the survey stats.
- If you remove any survey fields (aka Toolbox Fields), any data collected in that field will be lost upon removing it from your form.
You must unpublish a form in order to make changes. To do this, select Un-Publish in the upper-right corner.
Click OK to confirm that you want to unpublish the form.
Once the form is unpublished, you will be able to edit your form by clicking on the page icon.
Once you have completed your edits, re-publish your page. The link address will be the same as it was before you un-published the page to make changes. You will not need to send out a new link to your constituents.
You can view and export all your survey entries from the Statistics Report section of the survey detail page.
Click "All Entries" to see a list of all submissions. You can export all entries by clicking the "Excel" link.
Clicking the "All Entries" button will take you to the Survey Entries page for that survey. Click "View" to see the data submitted for a particular entry.
If your form is set up to create accounts, then the "Account ID" column will be populated with the individual account ID number for all entries, and the account's name will be displayed in the Name column. The Account ID will also display if the form was filled out from the Constituent Login Portal.
You can also see the entry on the responder's Account Detail page in the Survey Responses section, as shown in the example below. This will only populate for forms that create accounts or when an existing constituent fills out the form while logged in.
Click the name of a form in the response history to see the full entry.