"3D matrix calculations" plugin is used to calculate column and row total scores for the 3D Matrix questions. Row and column total scores will be calculated only for the open ended fields in the question.
- Add an additional scale element and answer option to store Totals for rows and columns.
- Then insert 3D matrix calculations plugin and adjust the following parameters:
1.Question - Reference to a question for calculating totals using the Qx notation.
2. Formula - Select the statistics to calculate the score, which can be Sum or Average.
3. Calculate - Select whether you want to calculate totals for rows, columns or both.
- After the plugin is applied, the total sum of the rows, columns or both will be automatically calculated.
Use this plugin if you want to track the time of a first access to your form. It can also create incomplete responses for the forms that were not filled out and submitted.
- Click the Insert button to use the plugin.
The plugin works only in the voting mode. The access time in test or preview modes will not be captured.
Time Question: Reference the answer option to store the access time. Use the Qx.Ay format where x is the question number and y is the answer number (i.e. Q2.A1); the plugin also supports question/answer identifiers.
Create Incomplete Response: If you choose Yes, incomplete responses will be created even if the form was not filled out and submitted. If you choose No, responses will not be tracked.
If your target respondents use BlackBerry devices they can type numbers and special symbols without switching the keypad to the numeric mode with the help of "BlackBerry Numeric Input" plugin.
To apply this plugin adjust the following parameters:
- *Extended Mode - Decide whether respondents could input numbers only (false) or numbers along with the special symbols (true).
- *Form Reference - Reference to the text field to apply current plugin for. Use Qx.Ay or Qx.Ay.Cz format, where x question number, y answer choice number, z column number (applicable for 3D Matrix questions).
See the symbol reference table below:
To use the plugin, click on the icon next to a question requiring a date.
To apply this plugin to your form/survey, specify following parameters:
- *Date Format - Select an appropriate date format. Y stands for year, M for month and D for day.
- *Form Reference - Reference the answer field you want to embed your calendar into. Please note that on the Single Line Text with Pre-format Options question type is compatible with this plugin. Use the Qx.Ay formatting, where x is a question number and y is an answer option number.
The column or bar chart plugin may be used as an instrument of data visualization, as an alternative to dashboards or column or bar charts available in a report by respondent. However, this plugin offers limited functionality to be used for simple tasks; on the other hand dashboards feature was designed specifically to target complex vizualizat
The Column or Bar chart plugin displays a column or a bar chart based on answers values inside a form or a survey. Built column or bar chart is also available in report by respondent. This chart visualizes numeric values from answer options of a Single line text question and only these data formats are supported:
currency(dollar, pound, euro);
number > 0 ;
To apply this plugin to your form/survey, specify following parameters:
- Chart type Choose one of the available types of chart : bar chart (horizontal) or column chart (vertical).
- Chart position Specify reference to a question after which the chart should be displayed. Use Qx or Qx.Ay or Qx.Ay.Cz notation.
- Chart width Specify chart width in pixels or reference to a question where a user types in chart width. By default, chart widht is set as 800px.Use Qx.Ay or Qx.Ay.Cz notation.
- Chart height Specify chart width in pixels or reference to a question where a user types in chart height.By default, chart widht is set as 600px.Use Qx.Ay or Qx.Ay.Cz notation.
- Chart title Specify chart title or reference to a question where a user specifies chart title.Use Qx.Ay or Qx.Ay.Cz notation.
- Chart color Select chart color. System provides a set of available colors: black, blue, green, red, dark red, orange, purple.
- Column or bar label character limit Specify character limit for Bar or Column labels or reference to a question where a user types in characters limit.Use Qx.Ay or Qx.Ay.Cz notation. Must be numeric. Only first X characters are displayed with following "..." for Bar or Column labels longer than the specified limit of X. By default this limit is set to 13 characters.
- Show data labels Select whether to show or not the labels of data.
- Show axis and grid Select whether to show or not axis and grid.
- *Show axis labels Select whether to show or not axis labels. Please note, that axis labels are shown only if axis line and grid are selected to be displayed.
- Axis unit Specify axis unit (or step) for vertical axis grid of Bar chart or horizontal axis grid for Column chart. Unfilled parameter means that axis unit will be calculated automatically according to referenced answer options. Use Qx.Ay or Qx.Ay.Cz notation.
- Minimum axis bound Specify minimum value for axis bound or reference to a question where a user types in minimum axis bound. Use Qx.Ay or Qx.Ay.Cz notation. Unfilled parameter means that minimum value from referenced answer options will be set as minimum axis bound. By default minimum value is set to 0.
- Maximum axis bound Specify maximum value for axis bound or reference to a question where a user types in maximum axis bound. Use Qx.Ay or Qx.Ay.Cz notation. Unfilled parameter means that maximum value from referenced answer options will be set as maximum axis bound.
- Source answer options Specify reference to an answer options of a question the column or bar chart will be based on. Use Qx.Ay or Qx.Ay.Cz notation
Quick edit button allows to enter and edit all references at once, each in separate line.
This plugin allows capturing the number of seconds the respondent spends on every page of the form.
To set up the plugin, specify 1 parameter:
Save time to* - Specify a Qx reference to the question where the time must be saved.
If you use open-ended questions in your survey or form for collecting comments or personal data, you can enlarge text fields to make data input more convenient. "Comment box" plugin initiates pop-up comment box by double or single click in the Multi-line or single line text fields.
Insert "Comment box" plugin and adjust the following parameters:
Event for Single Line Fields - This parameter is applicable if your survey or form contains one or more questions of the Single Line or Numeric Allocation type.Select the event to initiate bigger-sized comment box to pop-up:
None - Comment box will not pop-up until number of entered characters reaches number indicated within the next parameter.
Single Click - Comment box will pop-up when respondents click the text field only once or when the number of entered characters reaches number indicated within the next parameter.
Double Click - Comment box will pop-up when respondents double click the text field or when the number of entered characters reaches number indicated within the next parameter.
Amount of Characters for Single Line Fields - Indicate number of characters respondents should type to initiate pop-up window opening.
- Event for Multiline Fields - This parameter should be set in the same way as the first parameter if you need bigger-sized text-box to pop-up for Multiline type of question.
Amount of Characters for Multiline Fields - This parameter should be set in the same way as the second parameter if you need bigger-sized text-box to pop-up for Multiline type of question.
The Compare values plugin allows to compare values in two different text fields and warn the user if the values do not match.
The plugin is available for the following question types only:
How to setup the Plugin
- Set up the following plugin settings:
- Use the Qx.Ay (.Cz) format for the Field 1 and Field 2. The Cz stands for the 3D Matrix column.
- Allow to proceed - Specify either to allow or to restrict the respondent to proceed to the next page even if the values do not match.
- Warning message - Specify warning message that will be displayed if the entered values do not match.
When values provided by responders do not match, they will see a pop-up with your Warning message.
The Current Time Saver plugin captures the time at which the form was accessed by a respondent.
If enabled, the plugin will capture the current system time of the computer from which the form is accessed and save it to the question specified in the settings.
- The time will be recorded only when the Submit, Next or Save buttons are clicked.
- If the form has been divided into pages/sections, the time recorded will be the the time when the Submit, Next or Save buttons are clicked in the particular page/section that contains the target question, not the time when the complete response is saved or submitted.
To set up the plugin, specify the following parameters:
- * Format - Specify the format in which the date/time will be recorded.
- * Override existing value - Specify either to allow or to forbid overwriting time values recorded earlier.
- * Field - Indicate a question field, to which the plugin should save the value. It must be one of the visible fields of the Single Line Text with Preformat Options question type.
- If both the Current Time Saver and the Page Selector plugins are applied in the same form, the date and time will also be captured when a respondent navigates the form's pages using tabs.
- This plugin also works with question and answer identifiers, so you can use them instead of question and answer numbers in plugin parameters.
The scale that is applied to the question has the following format:
To apply "Drag and drop ranking" plugin setup the following plugin parameters:
- *Question Field - Use the Qx notation to reference to a Rate Different Items question, where x is the question sequence number within your survey or form.
- *Not Rated Elements - Applied plugin will separate out two areas. First area will contain items that has not been rated yet. For example, name this area: Not Rated Items.
- *Rated Elements - The second area is used to drag elements to and will contain already rated items. Sequence of the rated items from up to bottom corresponds to the question scale from left to right. Name this area, for example: Rated Items.
After plugin is applied to the survey the top rated element is rated as Disagree and the bottom element as Agree:
The checkbox is available for the following question types only:
- Check all (not available for the 'Other' answer option);
How to insert the tag
To apply this feature:
- Click on the Wrench on the right of the answer option field;
- Check the Exclusive box;
- Or Insert the<exclusive/> tag next to the answer choice you want to be exclusive.
- Save the question.
To insert the "Fixed header for Rate and 3D Matrix questions" plugin set up the following parameter:
- *Scrollable Questions - Use Qx=y notation to refer to a question you want to apply the fixed header, where:
x - question number within your survey or form;
y - height of fixed area in pixels.
Please keep in mind that the plugin is not working for mobile devices or native app.
How to use the Google Map
- Create a question of the Single-Line type that will be used as a coordinates holder.
- Insert the Google map plugin and adjust the following parameters:
- *Latitude - Reference to a question where location latitude should be saved. Use Qx.Ay format, where: x - question's position number; y - answer choice's position number within this question.
- *Longitude - Reference to a question where location longitude should be saved. Use Qx.Ay format, where: x - question's position number; y - answer choice's position number within this question.
- *Description - Reference to a question to save description of the respondent's location if any.
- Map Width - Define map width in pixels.
- Map Height - Define map height in pixels.
- Zoom Level - Choose zoom level of the map from 1 to 14, where 1 is a minimum zoom level and 14 is maximum zoom level.
- Centering Latitude - this parameter defines default latitude of the map. For example: 42.351262.
- Centering Longitude - this parameter defines default longitude of the map. For example: -71.059284.
If both latitude and longitude are specified as in the given example default map center will be Boston, MA.
- Centering Street Address - if you do not have coordinates for the certain location you can indicate street address and map will be centered on it by default. For example: Forbes Road, Braintree, MA, United States
- Map Location - Indicate map location within your survey or form. Use Qx format to reference to a question above which Google Map will be displayed to respondents.
- GoogleMap API Key (HTTP) - If you are running a standard (non encrypted, non masked) survey on the app.keysurvey.com or app.form.com domain leave this field blank. If you are running your survey from a different domain other than app.keysurvey.com you need to obtain a key by following this link .
- GoogleMap API Key (HTTPS) - If you are running an ancrypted (non masked) survey on the app.keysurvey.com or app.form.com domain (if the survey url starts with: https://app.keysurvey.com/ or https://app.form.com/) leave this field blank. If you are running your survey from a different domain other than app.keysurvey.com you need to obtain a key by following this link
- GoogleMap API Key (IP) - If you are running a survey using the IP address instead of a standard url, if the survey url starts with the Key Survey or Form.com IP (http://188.8.131.52/) leave this field blank. If you are running your survey from a different IP other than http://184.108.40.206/ you need to obtain a key by following this link
When respondents open their form, the Google Map will be displayed. To point their location respondents will need to use red marker available on the map.
Let's take a look on example:
The GPS Location plugin allows you to record the GPS location of a mobile device used by respondents.
Also you can store the location of a respondent using a handheld device equipped by a GPS receiver.
If you distribute your form via a master link, make sure you use the one with the SSL certificate applied:
To set up the plugin specify the following parameters
*Latitude field: insert the question number that will store the latitude value.
*Longitude field: insert the question number that will store the longitude value.
*Hide latitude and longitude fields: Hide the fields.
- The GPS Location plugin can be applied to the Single line text with pre-format options question type only.
- The plugin does not obtain GPS location if a respondent uses the Desktop version of the app; in such cases, the answer field where GPS position parameters should be stored will be empty.
- The plugin does not work with questions that were hidden using the 'Hide' checkbox when viewing the Form in the edit mode. We suggest using the Show/hide logic tools to avoid incompatibility issues with our platform.
Note that this plugin also works with question and answer identifiers, so you can use them instead of question and answer numbers in plugin parameters.
This plugin allows to display a "+" or "-" button next to a numeric fields to increment and decrement the number in the field by 1.
In order to setup the Plugin, you would be required to specify the:
- * Fields - Specify the form fields where the buttons to increment and decrement values should be displayed. The fields must belong to Single Line or Numeric Allocation question types.
- The plugin is not compatible with Rate Different Items Along The Scale of Your Choice, 3D Matrix and Compare One Against Another question types
- The plugin has limitations and does not allow to work with a large number of inputs in the Safari browser.
Use the New Page option from the Edit page to place a question that will be the first in a section on a new page:
This plugin allows you to define sections and enable section links in your form; thus, respondents will be able to navigate between sections in a no particular order. Page breaks for questions that start sections must be set beforehand.
Survey questions that contain logic and questions that respondents are redirected to upon logic must reside in the same section for logic to work properly.
To apply this plugin adjust the following parameters:
- *Add sections links to - This dropdown menu allows you to choose if you want to display the navigational links in the Header, Footer, or Header and Footer of every survey page.
- *Use question texts as links - Here you can define how the page selection links will appear. If set to true the question text of the first question in a section will be used as the links for page navigation. If set to false, sections will be named automatically as Page 1, Page 2 and so on.
- *First question in section - Indicate the question number, question reference (Qn) or the question identifier that should start the section. You can also use additional text for naming sections:
1 Introduction, 2 Personal Details, 3 Likes and Dislikes
Q1 Introduction, Q2 Personal Details, Q3 Likes and Dislikes
Qid Introduction, Qid Personal Details, Qid Likes and Dislikes
- You can add as many sections as you need by clicking the Add button. There must be no less than two sections.
- Question sections can contain more than one page.
- Survey questions that contain logic and questions that respondents are redirected to upon logic must reside in the same section for logic to work properly.
- If Branching logic is applied to a form with the Page selector plugin, then the "Must Answer" validation should be unchecked for those questions that are skipped according to the logical rules.
When adding plugin adjust the following parameters:
- *Match Substring - Select the way an entered text should match the indicated suggestions. If set to true the whole line will be searched for matching. If set to false only the beginning of the line will be searched for matching entered symbols.
- *Question - Reference the question answer choice for which typing suggestions will be displayed. Use Qx.Ay format for Single Line Text questions, and Qx.Ay.Cz or Qx.Cz format for 3D Matrix questions
- *Suggestions - Use this text box to enter typing suggestions that will be displayed to respondents. Separate each suggestion with a new line.
Use this plugin to log the time respondents spend on voting.
It requires to be set up in its own Single Line Text with Pre-Format Options question type with 8 answer options to store the plugin's parameters. Use the Show/Hide feature to hide this question from responders.
The Plugin may only be applied to the form once.
Use the Qx.Ay format where x is the question number and y is the answer number (i.e. Q2.A1). the plugin also supports question/answer identifiers.
How to use the Plugin
- Create a Single Line Text with Pre-Format Options question type with 8 answer options to store the plugin's parameters. Use the Show/Hide feature to hide this question from responders.
- Add the plugin and adjust the following settings. Use the Qx.Ay format where x is the question number and y is the answer number (i.e. Q1.A1). the plugin also supports question/answer identifiers:
Start time: Specify the answer option to record when the form was accessed by a respondent. The local time on a device will be recorded.
First submit time: Specify the answer option to record the first submission time. The local time on the device will be recorded.
Last submit time: Specify the answer option to record the last submission time. The local time on the device will be recorded.
Time between first submit and start: Specify the answer option to record the time passed between the first access and the first submission of the form (in seconds).
Time between last submit and start: Specify the answer option to record the time passed between the first access and the last submission of the form (in seconds).
Total number of seconds form pages were active on user's screen (may only work offline): Specify the answer option to record the total amount of time (in seconds) the respondent was viewing the form page (note that this option is limited to the FORM applications).
Number of times user returned to the form to change data: Specify the answer option to record the number of times a completed response has been modified.
Time zone offset: Specify the answer option to record the difference in minutes between the respondent's local time and UTC.
- Launch your form via one of the distribution methods.
Check the results
You can check the results on the Reports page.
- Click either on the Report button on the Forms page, or go to the Reports page.
- Click on the View button on next to the Single Line Text with Pre-Format Options question with pre question with a set Plugin;
- See the results.
The Score Calculator plugin is used for calculating total scores either in a single question or a questions section.
After assigning values to answer choices using the Branch on Range feature, apply this plugin to your form/survey and adjust the following parameters (those marked with * are mandatory):
- First Question in Section: Indicate the number of the first question in section to calculate the score, for example, 4.
- Last Question in Section: Indicate the number of the last question in section to calculate the score, for example, 10.
*Question to store score: Create new or use the existing question of the Single Line type as a destination for storing the calculated score. Use the Qx.Ay notation to reference this question. Note that the question to save the respondents' scores should be placed on a new page only after the block of questions it calculates a score for.
- Question to store maximum: This parameter shows maximum score that respondent could get upon submitting the survey. Use the Qx.Ay notation to reference a Single Line question to save results.
- Question to store percent: Based on the maximum score and the actual score that respondents got, this parameter calculates percentages from the maximum score. For example, if the maximum score is 100 points and respondent's result is 71, this parameter's value will be 71%. Use the Qx.Ay notation to reference a Single Line question to save results.
- Null values influence to max score calculation: Select Yes if answer options that were not set with a value(with empty score fields) should not be considered in total sum and calculation of percentage. Select No if you would like them to be a part of possible sum and percentage score.
Please note, that this plugin also works with the question and answer identifiers, so you can use them instead of question and answer numbers in plugin parameters.
The Score Calculator does not work in preview mode. Please use actual survey link to test plugin functionality.
"Select all checkboxes" plugin adds additional answer option to the Check All that Apply type of question that allows respondents to select all answers at once or clear all selections.
To apply this plugin adjust the following parameters:
- *Question - Reference to a question you want to apply this plugin to. Use the Qx notation, where: x - question sequence number.
See the example of question with applied plugin below:
"Signature area" plugin is used to create a signature area for the respondent to be able to digitally sign a Form/Survey.
In order to setup the plugin, you would be required to specify multiple parameters:
- Area Height - Specify the height of the signature field.
- Area Width - Specify the width of the signature field.
- Line Width - Specify the width of the signature line.
- Line Color - Specify the color of the signature line.
- Background Color - Specify signature background color. Use one of the following formats: #XXX or #XXXXXX. Default value is #f0f0f0.
- Border Color - Specify Signature Border Color. Use one of the following formats: #XXX or #XXXXXX. Default value is #000 (black).
- Date Color - Specify Signature Date Color. Use one of the following formats: #XXX or #XXXXXX. Default value is #000 (black).
- * Erase Signature if Back - Either enable or disable the signature from being erased upon pressing the back button or returning to the Form/Survey.
- * Show date - Select, whether a date should be shown or hide.
- * Question - Specify the question that the plugin will be applied to.
See an example of applied plugin and the list of parameters for its' implementation below:
- Area Height: 300
- Area Width: 700
- Line Width: 2
- Line Color: #000
- Erase Signature if Back: False
- Question: Q1
Upon applying the Plugin there should be a field of 300x700px which would allow the respondent to sign their response with a black color line and 2px width
"Slider" plugin is used to allow respondents selecting numeric values without entering them manually for Single-Line type of questions.
To apply this plugin adjust the following parameters:
- *Slider Width - Define slider width in pixels.
- *Lower Bound - Indicate the lower bound for slider values. This can be any negative or positive number. Respondents will not be able to select number less than this value.
- *Upper Bound - Indicate the upper bound for slider values. This can be any negative or positive number. Respondents will not be able to select number greater than this value.
- *Step - Indicate a step for slider selective values. Note that it should not be greater than difference between lower and upper bounds.
- *Answer field - Indicate reference to the answer choice to insert slider for. Use the Qx.Ay notation, where:
x - question position number;
y - answer choice position number.
If your question contains more than one answer choice click the Add button to add references to them.
Let's take a look on an example of applied plugin:
The Star ratings plugin displays stars instead of default radio buttons for the Rate Different Items Along the Scale of Your Choice type of question.
The plugin is available for the Rate Different Items Along the Scale of Your Choice question type only.
How to adjust the plugin settings
To apply this plugin adjust the following parameters:
- *Question - Reference to a Rate Different Items question using the Qx notation.
This is how referenced question will look:
Use this plugin whenever you need a respondent to specify time in an answer option. Time may be recorded in either 24-hour or 12-hour formats and may consist of hours, minutes, seconds, and the AM/PM designator.
The plugin works with the Single Line Text and the 3D Matrix question types only.
Time Picker plugin settings
On the Edit Plugin page there are the following settings:
Select the time format: Select the format to record the time. If the 12-hour clock is chosen, AM/PM option will be added.
Hours: Select how hours should be displayed.
Minutes: Select how minutes will be displayed.
Seconds: Select how seconds will be displayed. You may choose not to show seconds by using the Do not display option from the dropdown.
Question reference: Specify the answer field of a question that will store the time.
Use the Qx.Ay format where x is the question number and y is the answer number (i.e. Q2.A1); use the Qx.Ay.Cz format in 3D matrix questions, where z is the column number.
You can use scripts to customize the plugin. Click on the Script button on the upper toolbar.
For example, use the following script to add time intervals.
To check how the plugin works, click on the Preview button on the Edit Form page.
This plugin allows respondents to hide/show a question in a form using the toggling on/off custom HTML element, located in the same form.
Control ID: Specify the ID of an HTML element that when clicked on, should toggle the question visibility.
Question Reference: Reference a question the visibility of which should be toggled.
This plugin allows you to scan barcode formats using a camera on your device and save the retrieved data to the answer options of the Single Line Text type of questions. The plugin can be used for forms available on the Online Portal or by the General Link, and for iOS and Android applications.
Supported barcode formats
The plugin supports barcode formats for online and offline barcode scanning.
1D/2D barcode formats for offline scanning
(Forms available on iOS and Android applications)
1D/2D barcode formats for online scanning
(Forms available on the Online Portal or by the General Link)
If several instances of the plugin were set up in the same answer option, the most recent settings overwrite all the others.
Scan button position: Change the scan button placement in an answer option to which the button is attached: Left / Right / Center.
Scan button style: Change the appearance of the scan button in the form: Icon / Text.
Customize the scan button name: Change the name of the button if the 'Text' style is selected (not applicable to the 'Icon' style).
Block manual editing: Yes / No. Set to Yes to restrict editing of the scanning results (option available only for certain platforms).
Answer options: Reference the answer option in your form that will collect the scanning results. Use the Qx.Ay format where x is the question number and y is the answer number (i.e. Q2.A1).