Label sets

General

Label sets are basically list templates where each list has a set of codes with labels and it can be used in most question types either as answers or as sub-questions. Please bear in mind that LimeSurvey's label sets are merely copied to the particular question as sub-questions or answers. Therefore, if you change a label set after you 'used' it in a questionnaire, the changes will not propagate to the questions from the questionnaire where the respective label set was utilized.

This new usage of label sets gives much more flexibility for future development and makes the structure of a question more logical.

  A label set must be at least contain the same base language as the survey, else you will not be able to use it for any question of your survey.

You may find below a label set example. Manage user groups#How to... Click here if you want to go straight to the label set management functions of LimeSurvey.

If one wants to define a custom 7-point scale, a label set provides this function. In this example, a very simple custom label set with the code/label pairs is shown (the label is what appears in the actual questions).

Code	Label
1	Not useful at all
2	2
3	3
4	Somewhat useful
5	5
6	6
7	Very useful

You may find below a graphical example where three different smileys are used instead of label text:

How to...

Click on Manage label sets in the Configuration menu to edit, create, delete, import or export label sets.

...create or import new label set(s)

Click on the Create or import new label set(s) button located in the upper left corner of the page. You can either create a new label set from scratch or import it from your own computer:

• New label set: The label set(s) have to be manually created)
  • Set Name: Each new label set has to be given a name.
  • Languages: Every label set must be specified for the language it's used for. You can choose as many languages from the menu as you want.

• Import label set(s): In order to import a label set, click on browse and add the .lsl label set file. If you have previously created a label set, then LimeSurvey will not allow you import an external label set unless you turn off the Don't import if label set already exists option.

If you import a whole survey the label sets are imported too with the questions. Duplicate label sets are ignored.

...edit, delete, or export a label set

Each label set located in the Label sets list has a corresponding menu that contains the following four option:

• View labels: Allows the user to view the existing labels located in the respective label set.
• Edit label set: The user can rename the label set and/orr add/remove languages.
• Export label set: Export label set to a .lsl file.
• Delete label set: A window will pop up in order to confirm whether you want to delete the respective label set or not.

How to...

IMAGE - present

...add a label

You have to fill in a label code, assessment value and label-text and press on IMAGE to add the new label. It's possible to use a graphic instead of or additionally to a label text. To do that, you have to use HTML-code to include the graphic you want, e.g.:

<img border="0" src="http://www.yourdomain.at/pics/pic.gif">

To ease the editing process of the HTML-code, use the embedded HTML editor of LimeSurvey located at the end of the label-text box, represented by a green pen ( IMAGE )

...delete a label

In order to delete the label, click on the red trash button located under the Action column.

...rearrange a label

To rearrange the order of the labels, click on the green sign (IMAGE) located under the Position column.

...add a new language

If your label set has more than one language, you can choose which language you want to edit. Every label needs a code, an assessment value and a title. The code can only be changed in the base language of the label set. The assessment value can be ignored (set it to 0) if you do not use assessments. The title is the text, which is displayed in the question.

• Del-button: You can delete labels with the "Del"-button.
• Up/down-buttons: It's possible to change the row of labels by the "Up" and "Dn"-buttons.
• Fix sort: You can check the consistency and do a sort of the labels by pressing the "Fix Sort"-Button.

 Hint: Some useful label sets are available on the LimeSurvey site.