Actions

Quick start guide - LimeSurvey 3.0+: Difference between revisions

From LimeSurvey Manual

mNo edit summary
mNo edit summary
(40 intermediate revisions by 2 users not shown)
Line 16: Line 16:
This quick start guide was written for users of [https://www.limesurvey.org LimeSurvey Cloud]. If you use the [https://community.limesurvey.org LimeSurvey Community Edition], please refer to the [[Installation]] section in the LimeSurvey manual to install LimeSurvey on your own server.
This quick start guide was written for users of [https://www.limesurvey.org LimeSurvey Cloud]. If you use the [https://community.limesurvey.org LimeSurvey Community Edition], please refer to the [[Installation]] section in the LimeSurvey manual to install LimeSurvey on your own server.


=Create a Free LimeSurvey Account= <!--T:6-->
=Create a free LimeSurvey account= <!--T:6-->
Try it out now! Create a free [https://www.limesurvey.org LimeSurvey] account to test its features and core functions. Click the '''Sign Up For Free''' button or select '''Pricing''' on the [https://www.limesurvey.org LimeSurvey website] homepage and complete the registration.     
Try it out now! Create a free [https://www.limesurvey.org LimeSurvey] account to test its features and core functions. Click the '''Sign Up For Free''' button or select '''Pricing''' on the [https://www.limesurvey.org LimeSurvey website] homepage and complete the registration.     


Line 54: Line 54:


<!--T:15-->
<!--T:15-->
Click in each text box to reveal more details about each field. Subscribe to the LimeSurvey newsletter in order to receive help, tips, updates, service discounts, and the latest news.
Click in each text box to reveal details about required information for each field. Subscribe to the LimeSurvey newsletter in order to receive help, tips, updates, service discounts, and the latest news.


<!--T:16-->
<!--T:16-->
Line 66: Line 66:
After creating your LimeSurvey account, you will receive an email.  This email contains the account activation link.  Click the link to access your newly created account. Clicking the link takes you to your account on the [https://www.limesurvey.org/ LimeSurvey website].
After creating your LimeSurvey account, you will receive an email.  This email contains the account activation link.  Click the link to access your newly created account. Clicking the link takes you to your account on the [https://www.limesurvey.org/ LimeSurvey website].


=Setting Up Your Survey Site= <!--T:137-->
=Setting up your survey site= <!--T:137-->
   
   


<!--T:20-->
<!--T:20-->
You need to create a survey site before you can start creating and managing online surveys. Log in to your account and click the "Create survey site" button.   
You need to create a survey site before you can start creating and managing online surveys. Log in to your account and click '''''Create survey site'''''.   




Line 82: Line 82:
*Choose a domain name from the dropdown menu.
*Choose a domain name from the dropdown menu.
*Choose a server location.
*Choose a server location.
*Click the "Save & Set Up LimeSurvey Site" button.
*Click ''Save & Set Up LimeSurvey Site''.


<!--T:139-->
<!--T:139-->
Line 93: Line 93:


<!--T:28-->
<!--T:28-->
You can now access your survey site  by clicking the '''''View Survey Site''''' button at the top of the page. Sign in to your account using your  [https://www.limesurvey.org LimeSurvey.org] credentials.
You can now access your survey site  by clicking '''''View Survey Site''''' at the top of the page. Sign in to your account using your  [https://www.limesurvey.org LimeSurvey.org] credentials.




Line 104: Line 104:
<hr width="50%" style="margin:auto">
<hr width="50%" style="margin:auto">


=Start Using LimeSurvey= <!--T:31-->
=Start using LimeSurvey= <!--T:31-->
There is a toolbar in the top right corner of the page.  In the middle of the page, there are six boxes with shortcuts to the most commonly used LimeSurvey features.
There is a toolbar in the top right corner of the page.  In the middle of the page, there are six boxes with shortcuts to the most commonly used LimeSurvey features.


Line 131: Line 131:
***''Theme editor:'' Options that allow you to add/edit/delete survey themes, admin themes, or question themes. You can choose a theme to customize a survey as well as the LimeSurvey interface.
***''Theme editor:'' Options that allow you to add/edit/delete survey themes, admin themes, or question themes. You can choose a theme to customize a survey as well as the LimeSurvey interface.
***''Manage Label Sets:'' Label sets are a list of codes with labels that can be used as answers or as subquestions in most questions types.
***''Manage Label Sets:'' Label sets are a list of codes with labels that can be used as answers or as subquestions in most questions types.
***''Check Data Integrity:'' This checks the consistency and the redundancy of the data.
***''Check Data Integrity:'' This checks the consistency and the redundancy of data.
***''Backup Entire Database:'' Option for backing up the LimeSurvey data when an important upgrade is pushed or when the LimeSurvey application is moved to another server.
***''Backup Entire Database:'' Option for backing up the LimeSurvey data when an important upgrade is pushed or when the LimeSurvey application is moved to another server.
*'''Surveys:''' A survey includes: languages, question groups, questions, question attributes, answers, subquestions, default answers, assessments, quotas, quota members, and quota language settings. When clicking the green arrow, a window with the following options will appear:
*'''Surveys:''' A survey includes: languages, question groups, questions, question attributes, answers, subquestions, default answers, assessments, quotas, quota members, and quota language settings. When clicking the green arrow, a window with the following options will appear:
Line 138: Line 138:
**'''Copy a Survey:''' Lets you easily copy a survey that appears in the surveys list.  Once copied it can then be edited.
**'''Copy a Survey:''' Lets you easily copy a survey that appears in the surveys list.  Once copied it can then be edited.
**'''List Surveys:''' Lists all of your existing surveys.
**'''List Surveys:''' Lists all of your existing surveys.
*'''Response Balance:''' Shows the number of responses left on your subscription. As you only have access to a free account at the moment, you are limited to 25 responses per month. If you run out of responses, simply purchase more using [https://www.limesurvey.org/en/pricing the following link].
*'''Response Balance:''' Shows the number of responses left on your subscription. As you only have access to a free account at the moment, you are limited to 25 responses per month. If you run out of responses, simply purchase more using [https://www.limesurvey.org/en/pricing this link].
*'''Storage:''' This is the amount of MBs available to you to store your responses and surveys. You have 10 MB of storage space on your free account. If you need to increase the storage space, choose [https://www.limesurvey.org/en/pricing one of the following paid options from here].
*'''Storage:''' This is the amount of MBs available to you to store your responses and surveys. You have 10 MB of storage space on your free account. If you need to increase the storage space, choose [https://www.limesurvey.org/en/pricing one of the following paid options from here].
*'''Username:''' Here you can view your user preferences or log out of your account.
*'''Username:''' Here you can view your user preferences or log out of your account.
Line 173: Line 173:




==Create a Survey== <!--T:39-->
==Create a survey== <!--T:39-->


<!--T:40-->
<!--T:40-->
Line 196: Line 196:
*'''Basic Language''' This is the language used in the survey. The settings of the survey can be modified later to support additional languages.
*'''Basic Language''' This is the language used in the survey. The settings of the survey can be modified later to support additional languages.
*'''Sample Question:''' This feature is disabled by default. You can enable it to add a question group and question examples to your survey.  
*'''Sample Question:''' This feature is disabled by default. You can enable it to add a question group and question examples to your survey.  
*'''End URL:''' If users finish filling out the questionnaire, you have the option to redirect them to another page. If you wish to redirect them, place the URL into the field and activate the "automatically load URL" option that is located under the [[Surveys_-_introduction#Presentation_.26_navigation|Presentation & navigation tab]].
*'''End URL:''' If users finish filling out the questionnaire, you have the option to redirect them to another page. If you wish to redirect them, place the URL into the field and activate the "''automatically load URL''" option that is located under the [[Surveys_-_introduction#Presentation_.26_navigation|Presentation & navigation tab]].
* '''URL Description:''' A brief "End URL" description can be added if the user is re-directed to another webpage not related to the survey. It may be helpful to add a note (explaining the reason for the redirection to the respective URL).
* '''URL Description:''' A brief "End URL" description can be added if the user is re-directed to another webpage not related to the survey. It may be helpful to add a note (explaining the reason for the redirection to the respective URL).
*'''Date Format:''' This option is important when you want to record [[Notifications_%26_data|timestamps]] together with the survey participants' answers. You can click it to display a drop-down list of date formats. Choose the date format that your survey respondents will recognize (remember that different dates are used across the world).
*'''Date Format:''' This option is important when you want to record [[Notifications_%26_data|timestamps]] together with the survey participants' answers. You can click it to display a drop-down list of date formats. Choose the date format that your survey respondents will recognize (remember that different dates are used across the world).
Line 209: Line 209:


<!--T:46-->
<!--T:46-->
After completing the fields, click the Save and Close button located in the upper-right corner of the window. You will be redirected to the home page of your newly added survey.
After completing the required fields for '''Text Elements''', click ''Save'' in the upper-right corner of the window. You will be redirected to the home page of your newly created survey.  From the home page of the new survey, you will be able to add question groups and questions.




Line 215: Line 215:
<center>[[File:QSG LS3 General view.png]]</center>
<center>[[File:QSG LS3 General view.png]]</center>


==Create a Question Group== <!--T:48-->
==Create a question group== <!--T:48-->


<!--T:49-->
<!--T:49-->
A question group is used to group different elements of a survey like descriptions, questions, and responses.
Question Groups allow you to group questions together.  '''You must add a question group before adding questions'''.


<!--T:50-->
<!--T:50-->
Line 229: Line 229:


<!--T:52-->
<!--T:52-->
Click on the survey you wish to add the question group to. The survey page will be displayed. The menu on the left contains two tabs: [[Survey settings|settings]] and [[Survey structure|structure]]. It is necessary to work from the '''Structure''' tab when adding questions and question groups.
Click on the survey you wish to add the question group to. The survey page will be displayed. The menu on the left contains two tabs: [[Survey settings|Settings]] and [[Survey structure|Structure]]. It is necessary to work from the '''Structure''' tab when adding questions and question groups.


<!--T:53-->
<!--T:53-->
Line 244: Line 244:


<!--T:131-->
<!--T:131-->
Next, click on the '''Add question group''' button. The following page will be displayed.
Next, click the '''Add question group''' button. The following page will be displayed.




Line 253: Line 253:
<!--T:56-->
<!--T:56-->
*'''Title:''' This is the name of the survey group.
*'''Title:''' This is the name of the survey group.
*'''Description:''' A short description of the question group can be typed in. It will be displayed to the survey participants if the corresponding option is enabled from the settings of the survey.
*'''Description:''' A short description of the question group can be added. It will be displayed to the survey participants if the corresponding option is enabled from the settings of the survey.
*'''Randomization Group:''' This function is used to randomize certain question groups (the same must be allocated to the respective question groups).  
*'''Randomization Group:''' This function is used to randomize certain question groups (the same must be allocated to the respective question groups).  
*'''Relevance Equation''' This feature is used as a way to limit respondents to certain question groups based on their previous responses.  
*'''Relevance Equation''' This feature is used as a way to limit respondents to certain question groups based on their previous responses.  


<!--T:57-->
<!--T:57-->
Click the '''Save''' button in the upper-right part of the window once you are done.  
Click the ''Save'' button in the upper-right part of the window once you are done.  


<!--T:58-->
<!--T:58-->
{{Box|The last two fields on the screenshot, Randomization Group and Relevance Equation, are left empty because knowledge about the expression manager of LimeSurvey is required. If you would like to read more about them, start with [https://manual.limesurvey.org/Question_groups_-_introduction our wiki on question groups].}}
{{Box|The last two fields on the screenshot, Randomization Group and Relevance Equation, are left empty because knowledge about the expression manager of LimeSurvey is required. If you would like to read more about them, start with [https://manual.limesurvey.org/Question_groups_-_introduction our wiki on question groups].}}
{{Alert|title=Warning|text= You must create a question group first in order to start adding questions to your survey.}}


==Create a Question== <!--T:61-->
==Create a question== <!--T:61-->


<!--T:62-->
<!--T:62-->
Remember that you must first create a question group in order to create a new question. Please check the steps [[Quick_start_guide_-_LimeSurvey_3.0%2B#Create_a_question_group|presented above to see how you can add a question group to a survey]].  
Remember that you must first create a question group before you can add questions. Please review the steps [[Quick_start_guide_-_LimeSurvey_3.0%2B#Create_a_question_group|presented above for adding question groups]].  


<!--T:133-->
<!--T:133-->
Once you have finished creating the survey and adding a question group, select the '''Structure''' tab again and click on the add question button or click on the “add new question to group” button under the "Group quick actions" heading.  
Once you have created the survey and added a question group, select the '''Structure''' tab again and click '''''add question''''' from the left menu bar or click '''''add new question to group''''' under the ''Group quick actions'' heading.  




Line 278: Line 277:


<!--T:134-->
<!--T:134-->
Once clicked, the '''Create question''' page will be displayed. It contains the following options:
The '''Create question''' page will be displayed. It contains the following:




Line 287: Line 286:
<!--T:67-->
<!--T:67-->
*'''Code''' is a representation of the individual question name/code with which the survey is stored in the database.
*'''Code''' is a representation of the individual question name/code with which the survey is stored in the database.
*'''Question:''' This is the name of the question as it will appear to survey participants.
*'''Question:''' This is the question as it will appear to survey participants.
*'''Help:''' This is a short text that can be provided to help the survey participants better understand the question.
*'''Help:''' This is a short text that can be provided to help the survey participants better understand the question.
* '''General Options:''' The functionalities found in this option allow you to change the most important question-related settings. It includes four options:
* '''General Options:''' The functionalities found in this option allow you to change the most important question-related settings. It includes seven options:
**''Question Type:'' Many question types can be used in LimeSurvey. To better understand them, hover the mouse over each option or read [https://manual.limesurvey.org/Questions_-_introduction our wiki on questions].
**''Question Type:'' Many question types can be used in LimeSurvey. To better understand them, hover the mouse over each option or read [https://manual.limesurvey.org/Questions_-_introduction our wiki on questions].
**''Question Theme:'' You can choose a custom theme for the question (instead of the default).
**''Question Group:'' Here you can choose which question group you would like to add the question to.
**''Question Group:'' Here you can choose which question group you would like to add the question to.
**''Mandatory:'' This option is available for all question types. This setting allows you to require users to answer the question before they can move on to the next question.
**''Validation:'' This feature is available on all free text type or numeric questions. It is used for response validation. If the response is not validated, the user will be prompted to try again before they can progress.
**''Validation:'' This feature is available on all free text type or numeric questions. It is used for response validation. If the response is not validated, the user will be prompted to try again before they can progress.
**''Mandatory:'' This option is available for all question types. This setting allows you to require users to answer the question before they can move on to the next question.
**''Relevance Equation:'' This is a setting for advanced users. We recommend that the default value of "1" is used (it means that the item will always be shown).
**''Relevance Equation:'' This is a setting for advanced users. We recommend that the default value of "1" is used (it means that the item will always be shown).
**''Position:'' Choose where you want to position the question in the group.


<!--T:135-->
<!--T:135-->
Line 300: Line 301:


<!--T:68-->
<!--T:68-->
For example, if the '''Long free text''' question type is selected (the default option), then the following tabs will be displayed: '''General options''', '''Display''', '''Input''', '''Logic''', '''Other''', '''Statistics''', '''Timer'''.
For example, if the ''Long free text'' question type is selected (the default option), then the following tabs will be displayed: '''General options''', '''Display''', '''Input''', '''Logic''', '''Other''', '''Statistics''', '''Timer'''.
Click on the '''Save''' button. You will be redirected to a page that contains the summary of the recently added question.
 
<!--T:141-->
Complete the required fields and click ''Save''. You will be redirected to a page that contains the summary of the recently added question.




Line 311: Line 314:
To add more questions, follow the same procedure described above.
To add more questions, follow the same procedure described above.


==Add Subquestions and Answers== <!--T:71-->
==Add subquestions and answers== <!--T:71-->


<!--T:72-->
<!--T:72-->
Different types of questions require subquestions, predefined sets of answers, both or neither. For example, a question that requires the age of a survey participant does not require any subquestion or predefined set of answers. On the other hand, a simple array question requires both subquestions and answers.
Different types of questions may require subquestions, predefined sets of answers, both or neither. For example, a question that requires the age of a survey participant does not require a subquestion or predefined set of answers. On the other hand, a simple array question requires both subquestions and answers.


<!--T:73-->
<!--T:73-->
<div class="simplebox">[[File:help.png]] The lack of subquestions and/or sets of answers is highlighted if they are absent in the questions summary.</div>
<div class="simplebox">[[File:help.png]] If subquestions and answers are missing from a question that requires either/both, this is highlighted in the question summary.</div>


<!--T:74-->
<!--T:74-->
Line 330: Line 333:


<!--T:77-->
<!--T:77-->
To add subquestions, go to the top toolbar and click on '''Edit subquestions'''. Type in the subquestions you wish the survey participants to answer.
To add subquestions, go to the top toolbar and click '''Edit subquestions'''. Type in the subquestions you wish the survey participants to answer.




Line 338: Line 341:


<!--T:79-->
<!--T:79-->
<div class="simplebox">[[File:help.png]] Click on the ''green plus sign'' located under the '''Actions''' column to add more subquestions.</div>
<div class="simplebox">[[File:help.png]] Click the ''green plus sign'' located under the '''Actions''' column to add more subquestions.</div>


===Add Answers=== <!--T:80-->
===Add answers=== <!--T:80-->


<!--T:81-->
<!--T:81-->
To add a set of predefined answers, go to the top toolbar and click on '''Edit answer options'''. Type in the answers.
To add a set of predefined answers, go to the top toolbar and click '''Edit answer options'''. Type in the answers.




Line 352: Line 355:


<!--T:83-->
<!--T:83-->
<div class="simplebox">[[File:help.png]] Click on the ''green plus sign'' located under the '''Actions''' column to add more answer options.</div>
<div class="simplebox">[[File:help.png]] Click the ''green plus sign'' located under the '''Actions''' column to add more answer options.</div>


<!--T:84-->
<!--T:84-->
Line 373: Line 376:
Congratulations! You have successfully created your first array-type question.
Congratulations! You have successfully created your first array-type question.


==Organize Questions== <!--T:88-->
==Organize questions== <!--T:88-->


<!--T:89-->
<!--T:89-->
Line 382: Line 385:
<center>[[File:Reorder-question.png]]</center>
<center>[[File:Reorder-question.png]]</center>


==Activate/Stop Survey== <!--T:92-->
==Activate/stop survey== <!--T:92-->


<!--T:93-->
<!--T:93-->
Now that you have at least one question and question group added to your survey, you can activate it. Select the '''Settings''' tab from the menu on the left and click on the '''Overview''' option. The following page will be displayed.
Now that you have at least one question group and one question added to your survey, you can activate it. Select the '''Settings''' tab from the menu on the left and click on '''Overview'''. The following page will be displayed.




Line 393: Line 396:


<!--T:95-->
<!--T:95-->
Click the '''Activate this survey''' button on the toolbar.
Click '''Activate this survey''' on the toolbar.




Line 419: Line 422:


<!--T:102-->
<!--T:102-->
Once the desired functionalities have been enabled, just click on the ''Save & activate survey'' button. The following message will be displayed.  
Once the desired functionalities have been enabled, click ''Save & activate survey''. The following message will be displayed.  




Line 427: Line 430:


<!--T:104-->
<!--T:104-->
Select the option <u>'''No, thanks'''</u> to disable the closed-access mode! This will allow everyone to access to your survey using the survey link.
Select the option "''No, thanks''" to disable closed-access mode! This will allow everyone to access to your survey using the survey link.




<!--T:105-->
<!--T:105-->
Congratulations! You have activated your first survey! If you want to start sharing the survey URL, go to the home page of your survey, and look for the survey URL in the '''Survey summary''' section under 'Share your survey'.
Congratulations! You have activated your first survey! If you want to start sharing the survey URL, go to the home page of your survey, and look for the survey URL in the '''Survey summary''' section under ''Share your survey''.




Line 442: Line 445:


<!--T:108-->
<!--T:108-->
If you want to deactivate (stop) the survey, click on the '''Overview''' tab from the menu on the left and look for the '''Stop this survey''' button located on the top toolbar.
If you want to deactivate (stop) the survey, click the '''Overview''' tab from the menu on the left and look for '''Stop this survey''' located on the top toolbar.




Line 451: Line 454:


<!--T:111-->
<!--T:111-->
To quickly view your survey statistics, click on the '''Survey''' button located on the top toolbar of your LimeSurvey home page. A list with all the available surveys will be displayed. Next, go to the last column and click on the '''Statistics''' button ([[File:Quick start guide - see Statistics survey.png]]) that corresponds to the row of the survey you wish to analyse.
To quickly view your survey statistics, click '''Survey''' located on the top toolbar of your LimeSurvey home page. A list with all the available surveys will be displayed. Next, go to the last column and click the '''Statistics''' button ([[File:Quick start guide - see Statistics survey.png]]) that corresponds to the row of the survey you wish to analyse.




Line 459: Line 462:


<!--T:113-->
<!--T:113-->
A new window with a set of graphs will be displayed. If you would like to use them in a report, scroll to the bottom of the page and click on the '''Export images''' button. Each chart will be saved separately in.png format and archived as a.zip file.
A new window with a set of graphs will be displayed. If you would like to use them in a report, scroll to the bottom of the page and click '''Export images'''. Each chart will be saved separately in.png format and archived as a.zip file.


<!--T:114-->
<!--T:114-->
Click the 'Expert mode' button in the upper-right part of the window to access more statistics-related filters.  
Click '''Expert mode''' in the upper-right part of the window to access more statistics-related filters.  


<!--T:115-->
<!--T:115-->
Once you have chosen your filters, click on the '''View Statistics''' button in the upper-right corner of the window.
Once you have chosen your filters, click '''View Statistics''' in the upper-right corner of the window.




Line 475: Line 478:
The results are displayed in HTML, Excel, or PDF format based on which is chosen.
The results are displayed in HTML, Excel, or PDF format based on which is chosen.


==Exporting the Questions and Responses== <!--T:118-->
==Exporting questions and responses== <!--T:118-->


<!--T:119-->
<!--T:119-->
You can export survey results in a different format in order to produce statistics and graphs using apps such as SPSS, R, STATA, etc.. Access the survey you wish to analyze. Click on the '''Responses''' button on the top toolbar, and then select ''Responses & Statistics''.
You can export survey results in different formats to produce statistics and graphs using apps such as SPSS, R, STATA, etc.. Access the survey you wish to analyze. Click '''Responses''' on the top toolbar, and then select ''Responses & Statistics''.
   
   
   
   
Line 488: Line 491:


<!--T:121-->
<!--T:121-->
Now you are on the ''Browse Responses'' page. Look at the top toolbar for the '''Export''' button and select the desired format you wish to export to. If you select the first option, all the available formats in which you can export the data will be displayed.
Now you are on the ''Browse Responses'' page. Click '''Export''' from the top toolbar and select the desired export format. If you select the first option, all the available formats in which you can export the data will be displayed.




Line 500: Line 503:


<!--T:124-->
<!--T:124-->
Once the filters are set, click on the '''Export''' button located in the upper-right side of the window.
Once the filters are set, click '''Export''' located in the upper-right side of the window.


=Other LimeSurvey Features - Advanced Users= <!--T:125-->
=Other LimeSurvey features - Advanced users= <!--T:125-->


<!--T:126-->
<!--T:126-->

Revision as of 20:26, 16 April 2021

Other languages:
Note: The following is a basic quick start guide aimed at familiarizing you with the main functions and features provided by LimeSurvey. For a more detailed review of LimeSurvey and its capabilities, please refer to our manual. Another great way to get answers is to post your questions on our forums or join the LimeSurvey community chat on Discord. We look forward to hearing from you!

Introduction - What is LimeSurvey?

LimeSurvey is a free open source online survey application written in PHP and distributed under the GNU General Public License 2. The software enables users to create and publish online surveys, collect responses, create statistics, and export the results to other applications. You can install LimeSurvey on your own server (LimeSurvey Community Edition) or use our hosting service (LimeSurvey Cloud).

This quick start guide was written for users of LimeSurvey Cloud. If you use the LimeSurvey Community Edition, please refer to the Installation section in the LimeSurvey manual to install LimeSurvey on your own server.

Create a free LimeSurvey account

Try it out now! Create a free LimeSurvey account to test its features and core functions. Click the Sign Up For Free button or select Pricing on the LimeSurvey website homepage and complete the registration.



You will be taken directly to the registration page if you choose Sign Up For Free.

Four options will be displayed when Pricing is selected: Free, Basic, Expert, and Enterprise. Click on Register Now in the FREE option box. You will be redirected to the registration page.




Next, fill in the following fields:

  • Username: Choose a username for your account. Your username will also be used to access your LimeSurvey site.
  • Email: The activation link will be emailed to the email address provided.
  • Password: Choose a password, which will also be used to access your LimeSurvey site.



Click in each text box to reveal details about required information for each field. Subscribe to the LimeSurvey newsletter in order to receive help, tips, updates, service discounts, and the latest news.

Note: You can unsubscribe at any time by clicking on the link provided at the end of a newsletter.


After creating your LimeSurvey account, you will receive an email. This email contains the account activation link. Click the link to access your newly created account. Clicking the link takes you to your account on the LimeSurvey website.

Setting up your survey site

You need to create a survey site before you can start creating and managing online surveys. Log in to your account and click Create survey site.



To create your LimeSurvey site:

  • Enter your site name.
  • Choose a domain name from the dropdown menu.
  • Choose a server location.
  • Click Save & Set Up LimeSurvey Site.

The process can take up to 20 seconds. When the process is complete, the window will close and you will be taken back to your account page.



You can now access your survey site by clicking View Survey Site at the top of the page. Sign in to your account using your LimeSurvey.org credentials.



Start using LimeSurvey

There is a toolbar in the top right corner of the page. In the middle of the page, there are six boxes with shortcuts to the most commonly used LimeSurvey features.

The toolbar contains the following options:



  • Tutorials: Here, (in any LimeSurvey 3+ application), you will find a "Beginner Tour" tutorial to help you get a basic understanding of LimeSurvey and its most essential features.
  • Configuration: Here under the Settings, Users, and Advanced tabs, you will find options to help customize your LimeSurvey application, manage users and survey participants, and customize your surveys.
    • Settings: Options for customizing your LimeSurvey application.
      • Home Page Settings: Options for customizing the home page.
      • Global Settings: The changes made here are applied to the entire LimeSurvey application, including the non-superadministrator settings for all users.
      • Plugin Manager: Options for activating and managing all LimeSurvey plugins, which are supported by the LimeSurvey team. You can also add your own plugins.
      • Menu Configuration: Options for creating new menus or adding entries to existing menus.
      • Menu Entries Configuration: Options for creating, editing, or deleting menu entries.
    • Users: Options related to the management of users and survey participants.
      • Manage Survey Administrators: You can add new survey administrators from here.
      • Create/Edit User Groups: This function allows you to separate administration users into groups.
      • Central Participant Databases: You, as an administrator, can use this function to store the information of survey respondents in a central table/database that is independent of any table of participants.
    • Advanced Settings: Non-user or survey related settings that allow you to enhance your LimeSurvey application.
      • Theme editor: Options that allow you to add/edit/delete survey themes, admin themes, or question themes. You can choose a theme to customize a survey as well as the LimeSurvey interface.
      • Manage Label Sets: Label sets are a list of codes with labels that can be used as answers or as subquestions in most questions types.
      • Check Data Integrity: This checks the consistency and the redundancy of data.
      • Backup Entire Database: Option for backing up the LimeSurvey data when an important upgrade is pushed or when the LimeSurvey application is moved to another server.
  • Surveys: A survey includes: languages, question groups, questions, question attributes, answers, subquestions, default answers, assessments, quotas, quota members, and quota language settings. When clicking the green arrow, a window with the following options will appear:
    • Create a New Survey: Creates a new survey.
    • Import a New Survey: Imports a new survey.
    • Copy a Survey: Lets you easily copy a survey that appears in the surveys list. Once copied it can then be edited.
    • List Surveys: Lists all of your existing surveys.
  • Response Balance: Shows the number of responses left on your subscription. As you only have access to a free account at the moment, you are limited to 25 responses per month. If you run out of responses, simply purchase more using this link.
  • Storage: This is the amount of MBs available to you to store your responses and surveys. You have 10 MB of storage space on your free account. If you need to increase the storage space, choose one of the following paid options from here.
  • Username: Here you can view your user preferences or log out of your account.
  • Bell Icon: Click the green bell to view notifications related to your LimeSurvey application.



There are six boxes on the home page of your LimeSurvey application.



  • Create survey
  • List surveys
  • Global settings
  • Manage survey administrators
  • Label sets
  • Themes
The boxes are shortcuts (click on them) for the different LimeSurvey features. The boxes and their number can be changed from Configuration -> Home page settings.



Create a survey

To create a survey, click on the Create survey box.



The Create survey page will be displayed.



You will find the following on the Create survey page:

  • Survey Title: Type in your survey title here. This is a required field. The title of the survey can be changed later.
  • Basic Language This is the language used in the survey. The settings of the survey can be modified later to support additional languages.
  • Sample Question: This feature is disabled by default. You can enable it to add a question group and question examples to your survey.
  • End URL: If users finish filling out the questionnaire, you have the option to redirect them to another page. If you wish to redirect them, place the URL into the field and activate the "automatically load URL" option that is located under the Presentation & navigation tab.
  • URL Description: A brief "End URL" description can be added if the user is re-directed to another webpage not related to the survey. It may be helpful to add a note (explaining the reason for the redirection to the respective URL).
  • Date Format: This option is important when you want to record timestamps together with the survey participants' answers. You can click it to display a drop-down list of date formats. Choose the date format that your survey respondents will recognize (remember that different dates are used across the world).
  • Decimal Format: Two options are available: dot (.) and comma (,). Select the one that is most widely used in the region where your survey will be conducted (e.g., US vs Germany).
  • Description: A short description of the survey can be added here.
  • Welcome Message: The survey participants will receive the welcome message that is entered here.
  • End Message: Enter the message that participants will see once they submit their answers to the questionnaire (when the survey is complete).


There are six options on the top toolbar. The one you just read about is Text elements. The other five are: General settings, Presentation & navigation, Publication & access control, Notification & data management, and Participant settings (also known as Tokens). Clicking each will display more advanced menus. You can use them to enhance your survey. The survey can also be enhanced later from its settings once it is created, so selecting enhancements here is not required.


After completing the required fields for Text Elements, click Save in the upper-right corner of the window. You will be redirected to the home page of your newly created survey. From the home page of the new survey, you will be able to add question groups and questions.


Create a question group

Question Groups allow you to group questions together. You must add a question group before adding questions.

To create a question group, first choose the survey you want to add the question group to. You will find this option in the top toolbar of LimeSurvey's home page.



Click on the survey you wish to add the question group to. The survey page will be displayed. The menu on the left contains two tabs: Settings and Structure. It is necessary to work from the Structure tab when adding questions and question groups.


The menu will appear as follows when the Structure tab is selected.



Next, click the Add question group button. The following page will be displayed.



  • Title: This is the name of the survey group.
  • Description: A short description of the question group can be added. It will be displayed to the survey participants if the corresponding option is enabled from the settings of the survey.
  • Randomization Group: This function is used to randomize certain question groups (the same must be allocated to the respective question groups).
  • Relevance Equation This feature is used as a way to limit respondents to certain question groups based on their previous responses.

Click the Save button in the upper-right part of the window once you are done.

The last two fields on the screenshot, Randomization Group and Relevance Equation, are left empty because knowledge about the expression manager of LimeSurvey is required. If you would like to read more about them, start with our wiki on question groups.


Create a question

Remember that you must first create a question group before you can add questions. Please review the steps presented above for adding question groups.

Once you have created the survey and added a question group, select the Structure tab again and click add question from the left menu bar or click add new question to group under the Group quick actions heading.



The Create question page will be displayed. It contains the following:



  • Code is a representation of the individual question name/code with which the survey is stored in the database.
  • Question: This is the question as it will appear to survey participants.
  • Help: This is a short text that can be provided to help the survey participants better understand the question.
  • General Options: The functionalities found in this option allow you to change the most important question-related settings. It includes seven options:
    • Question Type: Many question types can be used in LimeSurvey. To better understand them, hover the mouse over each option or read our wiki on questions.
    • Question Theme: You can choose a custom theme for the question (instead of the default).
    • Question Group: Here you can choose which question group you would like to add the question to.
    • Mandatory: This option is available for all question types. This setting allows you to require users to answer the question before they can move on to the next question.
    • Validation: This feature is available on all free text type or numeric questions. It is used for response validation. If the response is not validated, the user will be prompted to try again before they can progress.
    • Relevance Equation: This is a setting for advanced users. We recommend that the default value of "1" is used (it means that the item will always be shown).
    • Position: Choose where you want to position the question in the group.

Please note that, depending on the type of question selected, different tabs will be displayed below the General settings tab. To find out more about this, we suggest that you to first read the following wiki section.

For example, if the Long free text question type is selected (the default option), then the following tabs will be displayed: General options, Display, Input, Logic, Other, Statistics, Timer.

Complete the required fields and click Save. You will be redirected to a page that contains the summary of the recently added question.



To add more questions, follow the same procedure described above.

Add subquestions and answers

Different types of questions may require subquestions, predefined sets of answers, both or neither. For example, a question that requires the age of a survey participant does not require a subquestion or predefined set of answers. On the other hand, a simple array question requires both subquestions and answers.

If subquestions and answers are missing from a question that requires either/both, this is highlighted in the question summary.

The next screenshot contains an array-type question.



Add subquestions

To add subquestions, go to the top toolbar and click Edit subquestions. Type in the subquestions you wish the survey participants to answer.



Click the green plus sign located under the Actions column to add more subquestions.

Add answers

To add a set of predefined answers, go to the top toolbar and click Edit answer options. Type in the answers.



Click the green plus sign located under the Actions column to add more answer options.

Save the set of answers and preview the question (look for the Preview question button located on the top toolbar).



Our question looks like this:



Congratulations! You have successfully created your first array-type question.

Organize questions

If your survey contains dozens of questions, it is a time-consuming process to access each question and/or question group and edit the order one-by-one. The survey Structure menu allows you to quickly reorganize your questions and question groups. Select the Structure tab from the menu on the left and click on the three-line symbol that is located in front of the question or group name and drag it to its new location.


Activate/stop survey

Now that you have at least one question group and one question added to your survey, you can activate it. Select the Settings tab from the menu on the left and click on Overview. The following page will be displayed.



Click Activate this survey on the toolbar.



Before activation, a window will be displayed asking you about general survey settings.



  Attention : You will not be able to add or delete groups, questions, subquestions or change their codes once the survey is activated.


  • Anonymized Responses: This option allows you to decide if the information in your survey's token table is matched to the responses in your survey or kept anonymous. If you decide to enable it, your survey is set to anonymize responses. You will not be able to link answers to respondents.
  • Save IP Address: If enabled, the IP address of the survey respondent will be stored together with his/her answers.
  • Save Timings: If enabled, the time spent on each page of the survey by each survey participant is recorded.
  • Date Stamp: Turn this option on if you would like to see the date the answers were submitted.
  • Save Referrer URL: If enabled, the referrer URL will be stored together with the answers.

Once the desired functionalities have been enabled, click Save & activate survey. The following message will be displayed.



Select the option "No, thanks" to disable closed-access mode! This will allow everyone to access to your survey using the survey link.


Congratulations! You have activated your first survey! If you want to start sharing the survey URL, go to the home page of your survey, and look for the survey URL in the Survey summary section under Share your survey.



Copy the link and start sharing it.

If you want to deactivate (stop) the survey, click the Overview tab from the menu on the left and look for Stop this survey located on the top toolbar.


Statistics

To quickly view your survey statistics, click Survey located on the top toolbar of your LimeSurvey home page. A list with all the available surveys will be displayed. Next, go to the last column and click the Statistics button () that corresponds to the row of the survey you wish to analyse.



A new window with a set of graphs will be displayed. If you would like to use them in a report, scroll to the bottom of the page and click Export images. Each chart will be saved separately in.png format and archived as a.zip file.

Click Expert mode in the upper-right part of the window to access more statistics-related filters.

Once you have chosen your filters, click View Statistics in the upper-right corner of the window.



The results are displayed in HTML, Excel, or PDF format based on which is chosen.

Exporting questions and responses

You can export survey results in different formats to produce statistics and graphs using apps such as SPSS, R, STATA, etc.. Access the survey you wish to analyze. Click Responses on the top toolbar, and then select Responses & Statistics.




Now you are on the Browse Responses page. Click Export from the top toolbar and select the desired export format. If you select the first option, all the available formats in which you can export the data will be displayed.




Once the filters are set, click Export located in the upper-right side of the window.

Other LimeSurvey features - Advanced users

Check out the features of the LimeSurvey Cloud package.

Still have questions? Please join our LimeSurvey community chat on Discord.


Retrieved from "http://manual.limesurvey.org/index.php?title=Quick_start_guide_-_LimeSurvey_3.0%2B&oldid=161990"