Actions

Question groups - introduction

From LimeSurvey Manual

Revision as of 18:00, 25 February 2024 by Joeyh278 (talk | contribs) (capitalize heading)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


Please note that the below explanations and screenshots are based on LimeSurvey 3.


Create question group

Groups are a great way to organize your surveys by placing them into categories (groups). How you categorize your surveys/groups is completely up to you.

To add question groups to your survey:

(1) From the survey structure tab of your survey click +Add question group.



After you click Add question group, the add question group panel will be displayed.

(2) Complete the required fields.



Add question group fields

  • Title: Type in this box the name you wish to give to the question group;
  • Description: This field allows you to publish an explanatory note for any set of questions. If you add a description, it will be presented along with the survey before commencing any of the questions in that group. If no text is added, then public participants will simply move straightaway to the survey questions. You can use the HTML editor to include images, formatted text, etc. to your liking;
  • Randomization group: To start randomizing a question group, enter a string into the field such as randgroup1. You will need to enter that same string in all question groups that you want to randomize and which will then appear in a random order when taking the survey. Only places inside the same group will be randomly switched!
  • Relevance equation: You can set a "relevance equation" in this field for the group with the help of the ExpressionScript. This is helpful for "looping" or other cases where you are repeating similar content multiple times. For example, say you want to ask the same set of follow-up questions for each child in a household and you have asked how many children are there via a question named numKids. Then, for each group of follow-up questions you would have to use relevance equations (which would collect data about the third child) such as: numKids == 3;
Note: An explanation and example for hiding question groups are available in the [examples wiki subsection].
Hint: Groups can be used to group questions in a survey. If you are going to have multiple groups, you should note that the survey questions will be displayed group by group by default (you can change that from your survey settings). To display the groups in a particular order using the group reordering feature. If you have only one group in your survey then the name of this group is irrelevant (except for the survey format).


You can create as many groups as you like!


Add question group toolbar

You will find the following options on the top toolbar:



  • Display/Export: This function is used to export your whole survey in different formats.
  • Survey participants: Clicking this button will redirect the survey administrator to his/her survey participants table.
  • Responses: If the survey is active, the button becomes visible. It offers you access to the responses table.
  • Import a group: Besides the two ways mentioned above, new question groups can also be added via the import group function.

Import a question group

You can also import a question group (.lsg file format) that was previously exported from a LimeSurvey survey.


(1) From the survey Structure tab, click +Add question group.

(2) Click Import a group on the top toolbar.



(3) Browse your computer/server and upload the .lsg file that contains the question group you wish to import.


Question group actions

After the creation of a survey, you can access the newly created group from the survey structure menu. The following page will be displayed:



The page is divided into three sections:

  • Question group toolbar: You will find the following options on the toolbar:
    • Preview survey/question group: Click one of the two buttons to either preview your whole survey or only the current question group. If additional languages were added to your survey, the survey/question group can be previewed in each language of the survey. Just click one of the two preview buttons and select the desired language.
    • Edit current question group: Click this button to edit the title, description, relevance equation, or randomization group of the current question group.
    • Check survey logic for current question group: This helps you see the possible errors that might exist within a question group - it is especially useful when the ExpressionScript is used.
    • Delete current question group: To delete the current question group, click this button.
    • Export this question group: If you wish to export this question group to later import it into another LimeSurvey survey, click this button. The file will be exported in the .lsg format.
  • Group quick actions: This allows you to quickly perform question-groups-related actions - in our case, the add new question to group option is displayed. To find out more about questions, read our introductory wiki section on question.

Preview question group

Once you have started to add questions into your group, you may want from time to time to preview how the respective question group looks. To do that, look for the question group button that can be accessed from the:

When previewing a group, the relevance of this group is automatically forced to true.
 Hint: You can add GET params in URL to prefill questions.


Preview question group - survey structure

Click the survey Structure tab, select the desired Question group, and click preview question group:


Preview question group - question group panel

You can preview the question group once you have finished editing it.


Preview question group - question panel

The question group to which questions belong can be previewed from the question panel - see the top bar:


Reordering question groups

The question groups and questions can be reordered. For further details, read the survey structure wiki subsection.

Example

The relevance equation offers many possibilities to further customize your survey. A simple example is presented below to show how some question groups can be hidden according to the answer provided by the respondent to a prior question (part of another question group). For example, if you want to find out more information about parents that have one child in comparison to those with two or more, using the relevance equation to hide certain questions/question groups is recommended.


Link .lss file: Question_groups_simple_example.zip -> For instructions on how to import the file, refer to the following wiki section.



The above file contains three question groups, each containing one question. Question group "1kid" is displayed only if the value introduced by the respondent to the question "numkids" is 1. Question group "2ormorekids" is displayed only if the answer to the question "numkids" is >1.

This is just a simple example to show how expressions can be used to further customize your survey. For more details, please read about the ExpressionScript functionality.

Notes:
  • There are several ways to hide questions. One is to use conditions. However, for more complex surveys, the ExpressionScript has to be used.
  • If you use expressions, don't forget to look for syntax errors with the help of the logic file.