From LimeSurvey Manual

Other languages:
Deutsch • ‎English • ‎Nederlands • ‎français • ‎slovenščina • ‎日本語
Help.png Hint: You can create more sophisticated assessments and reports using the ExpressionScript. It lets you access all variable types and easily generate tailored reports at any point in the survey (not only at the end). Using the new Equation question type, LimeSurvey can automatically save your assessment calculations and/or report to the database.


LimeSurvey contains a feature that allows survey administrators to create survey "assessments" for his or her respondents - even for multilingual surveys. Assessments are rules which evaluate the responses to a survey immediately after it is submitted, displaying text blocks to the survey participant (based on that evaluation).

In order to use LimeSurvey's assessment feature, access the survey menu and click on the Assessments tab:

Assessments - location.png

Once there, enable the assessment mode:

LS3 - enable assessments.png

Help.png To be able to create and edit assessments in the older versions of LimeSurvey (e.g., 2.x), visit the survey settings and enable the assessment mode from the Notification & data management tab. Once done, additional fields where you can introduce assessment values will show up when editing answers.

How do assessments work

Let's construct a simple example that can help you better understand the way in which the assessment mode is supposed to work.

Imagine you have two questions in your survey, the first question asks if the user smokes: "Do you smoke?". The question has 3 possible answers, "Yes, more than 10 per day" with a value of "10", "Yes, but less than 10 per day" with a value of "5", and "No, I don't smoke at all" with an assessment value of "1".

The second question "Do you exercise?" has three possible answers: "Yes, I exercise for at least half an hour three times a week" with a value of "1", "Yes, I exercise every now and then" with a value of "5" and "No, I don't ever do any exercise" with an answer code/value of "10".

If we were to add the totals of the values for each possible answer at the end of the survey, we'd get a good indication of the general health of the respondent. Someone who smokes and doesn't ever do any exercises will score 10 points for each answer, getting a total score of 20 when we add the two values. Someone who doesn't smoke and exercise will score 1 for each answer, obtaining, in the end, a total score of 2.

A sample survey demonstrating the use of assessments is available for download. You can import this survey into your own LimeSurvey installation via the import function: File:Limesurvey sample survey Assessment.lss.


Once enabled, the following page will load up:

Assessments panel 1.png

To start creating new assessments rules complete the fields located below the Assessment rules table. The following options are available:

  • Scope: You can choose either Total or Group. The first will create an assessment based on the sum of all the submitted answers in the entire survey. The latter will create an assessment based on the sum of all the submitted answers from a question group;
  • Group: The dropdown list allows you to choose the question group you wish to assess.

If you selected Total before, then the Group field will not influence the assessment of the survey answers - important when the {PERC} placeholder is used.
  • Minimum: The minimum score to which this assessment will apply.
  • Maximum: The maximum score of answers to which this assessment will apply;

Let's take again the example presented above. If a respondent scored between 1 (minimum) and 10 (maximum), then the assessment feature would display a message telling the respondent that he or she has a good health condition. If he or she scored between 11 (minimum) and 20 (maximum), then the assessment feature would display on the last page a message related to the not-so-good health condition of the respondent.
  • Heading: The heading of the assessment which will be displayed if the assessment is going to be displayed;
  • Message: It represents the text message of the assessment - what is displayed at the end of the survey to the respondents. You can use the placeholders such as {PERC} and/or {TOTAL} to emphasize the scores of each survey question group or the total survey score. Click on the green pencil button to access the HTML-editor and enhance the final message of the assessment by adding colours, tables, images, and so on.

You can create as many assessments as you like, and you can create more than one assessment to display for a given score.

After adding some assessments, the possible assessments actions will be displayed under the Actions column in the Assessments rules table. From there, you can either edit or delete an assessment rule:

Assessments panel 2.png

Help.png It is important to note that if you use assessments, you must ensure that you have not enabled the autoload the URL option. If it is enabled, no end page with the text of the assessment rule will be displayed anymore and LimeSurvey will automatically load the URL field from the Presentation. You can disable it from the same tab.

How question types are evaluated

There are certain question types which will not be assessed or will be assessed in a special way. Some of the questions cannot be used with the assessment feature. However, they can be replaced with assessable question types. For example, a 5 point choice can always be replaced with a simple list (radio) question type.

The following question types can always be assessed:

  • Array (Flexible labels) dual scale
  • Array (Flexible labels)
  • Array (Flexible labels) by column
  • List (Flexible labels) (Dropdown)
  • List (Flexible labels) (Radio)
  • List (Dropdown)
  • List (Radio)
  • List with comment
  • Multiple options
  • Multiple options with comments

The following list contains question types that cannot be assessed:

  • 5 point choice
  • Array (5 point choice)
  • Array (10 point choice)
  • Array (Increase, Same, Decrease)
  • Array (Multi flexible) (Text)
  • Array (Yes/No/Uncertain)
  • Array (Multi Flexible) (Numbers)
  • Text display
  • Date
  • Gender
  • Huge free text
  • Language switch
  • Long free text
  • Multiple numerical input
  • Numerical input
  • Ranking
  • Short free text
  • Yes/No

Set assessment values for each answer/label

If enabled, the assessment mode will add an additional field between the answer code and answer option name for all the assessable questions:

Assesment value set.png

You can also use label sets as answers for your set of questions. Just click on the Predefined label sets... button located under the answers matrix and select your predefined label set.

If you decide to use label sets, assessment values can be added to all your labels from the moment in which they are first created. This allows the survey administrator to quickly use few assessed predefined label sets as answers for multiple sets of questions.

Labels table.png

This process is less time-consuming and more practical. You can create a plan in the early stages of your survey in order to use only one set of label sets with predefined assessment values for multiple questions. In this way, you will not have to manually add assessment values to all the answers of the assessable questions used in your survey.

Help.pngTo find out more about the label sets and their usage, read the following wiki section.

Assessment placeholders

When using assessments the following placeholders are available:

  • {PERC}: It displays the scoreof a question group. It can be used only in the message field of the assessment rule!
  • {TOTAL}: It displays the total score. It can be used only in the message field of the assessment rule!
  • {ASSESSMENT_CURRENT_TOTAL}: This placeholder can be used within a survey to display the current total score. Keep in mind that the score is only updated when the respondent clicks on the "Next" button. Therefore, it is useless in an all-in-one survey. Also, its use requires the existence of at least one assessment rule. Otherwise, the placeholder will not display any value.

If your survey is not anonymous, the following placeholders are available.

  • {TOKEN:EMAIL}: It displays the email of the respondent from the survey participants table
  • {TOKEN:FIRSTNAME}: It displays the first name of the respondent from the survey participants table
  • {TOKEN:LASTNAME}: It displays the last name of the respondent from the survey participants table
  • {TOKEN}: It displays the token code of the respondent from the survey participants table

Tips & tricks

Save assessment value in data

To save assessment value in data and have it in export : you can create a Question_type_-_Equation and put {ASSESSMENT_CURRENT_TOTAL} in the equation setting.

Use {ASSESSMENT_CURRENT_TOTAL} without assessment message

If you don't add any assessment message : no assessment message are shown.

How to disable the assessment mode

To deactivate it, go to the survey menu and look for the Data management tab. Click on it and the Notification and data management panel will be displayed. Look for the Enable assessment mode option and click on it to have it disabled for the respective survey.

Disable assessment mode - picture.png


How to use the assessment mode

Let's recreate the example presented above in order to better understand the steps you have to pursue in order to correctly use the assessment feature.

Help.pngIf you are unsure how to create a survey, use the following quick start guide.

1) Create the survey

2) Activate the assessments. Go to the settings menu of the survey and click on the Assessments tab. Once there, activate the feature:

LS3 - enable assessments.png

3) Create a question group and start adding the questions. Your survey structure should look like this:

Example assessment - question group.png

  Attention : Do not forget to check the whether the questions are assessable or not! Otherwise, no assessment value field will be displayed in the edit answer options panel.

4) Add answers for each question created above. While adding/editing the answers, complete also the assessment value field for each answer:

Example assessment - edit answers.png

5) Now that you know the assessment values, access the Assessments panel and start adding assessment rules. Two rules were created for this example:

Assessments example - assessment rules.png

The text message of the first assessment rule (You should start exercising!) will be displayed if the respondent scores between 1 and 10 points. The text message of the second assessment rule (Well, that's what I call being healthy!) will be shown if the respondent scores between 11 and 21 points.

6) Now, preview the survey and see if the assessment mode is active. At the end of the survey, a text message will be displayed based on the score obtained by the respondent.

Help.png Note: The score is not displayed in this example! If you would like to have it displayed in your assessment, create more assessment rules (for each possible scenario) or use assessment placeholders.

Assessment results.png

How to use the assessment placeholders

As mentioned in the previous subsection, three assessment-related placeholders can be used: {PERC}, {TOTAL}, and {ASSESSMENT_CURRENT_TOTAL}.

In the previous example, the following result was obtained: "Well, that's what I call being healthy!". However, no score was displayed.

There are many ways through which you can have it displayed. You can either create 6 assessment rules in order to emphasize each possible score/result or use assessment placeholders. The below example explains the latter option.

As mentioned above, {PERC} and {TOTAL} can be used in the message text box of the assessment rule in order to emphasize the score of the current group and the total score, respectively. Let's take a look at the following two screenshots to understand their usage.

Example perc - assessments - part 1.png

In the first screenshot, {PERC} and {TOTAL} were added into the message text box of the assessment rule.

Example perc - assessments - part 2.png

In the second screenshot, you can see how the assessment rule looks like in order to correctly use both placeholders. Because {PERC} is used, the scope of the assessment rule must be switched from Total to Group in order to correctly display the score of the question group selected from the Question group dropdown list:

Example assessment - right question group.png

After completing the survey and depending on their answers, the respondents should get the following assessment message at the end:

Assessment results - perc and total.png

{ASSESSMENT_CURRENT_TOTAL} can be used only inside a survey. You can use it after each question or question group from a quiz. You could show in this way to each respondent his or her current quiz/survey score. To use it, you could add for example at the beginning of every question or question group a message like: "You have accumulated till now {ASSESSMENT_CURRENT_TOTAL} points".

Help.png Hint: Check the following YouTube video to see in which other situations you can use placeholders.

Video tutorial

To understand the basics of the LimeSurvey assessments feature, check the following video.