Iterate over a pre-defined set of response options

Home / DatStat Illume Product Documentation / Looping / Iterate over a pre-defined set of response options

Example of an “Iterate over a pre-defined set of response options” Loop Summary Table


This type of loop allows the respondent to loop through a series of questions based on a predefined set of responses.    The Import from Question feature can be used in conjunction with this scenario, such that the scale from another question can be automatically imported, with show-if logic automatically applied to each option in the scale.

Creating a Pre-Defined Loop


  1. Create the variables that will be used to define the Loop, For Example a Select One Question that provides the list of responses to use for each Loop Iteration.
  2. Create the Loop Object and click OK
  3. Using the right pane select the Object to add the Pre-defined Question
  4. Go back to the Loop Object
  5. Enter the appropriate information in the General Tab
  6. Select Iterate over a pre-defined set of response options in the Loop Iterations Tab
  7. Under Add/Edit Loop Iteration Response Option, you may enter each response option one by one from the prior question


Alternatively, or you may use the Import from Question option to import the response options from the previous question.  This can be opened by clicking Import and selecting “Import from Question” from the poplist.  When Import from Question is utilized, you may check the box to “add show to only show imported responses if answered for selected question”, meaning that the loop will only occur if the option was selected in the prior question.


  1. In the Loop Options tab, enter the Table Prompt, and the appropriate values for the Minimum and/or Maximum number of loops.  If no Summary Table is desired, uncheck the Summary Table check box.
  2. In the Loop Summary Columns Tab select the appropriate Columns to include in the Summary Table.

For this table there are two additional types of Columns:

  • Iteration Label – The label or sequence number of a loop iteration – This will reference the Loop Iteration Response Options created earlier.
  • Survey Data – The value of the loop or survey variable – This will reference the responses created in the Variable inside the Loop in step 3.




  1. For the Loop Summary Options Tab, by default the buttons and indicators are set in preferences. To create custom button text, or use a different button graphic, uncheck Use Survey Preferences.
  2. To create custom indicators of Answered/Unanswered Loops uncheck the Use Survey Preferences.
  3. Set the appropriate Show-If logic for the Loop Object if desired and Click OK to save.