Question Types: Nested List

Written by Sydney Henderson

Last published at: April 14th, 2021

The nested list feature must be turned on in your site to use. To discuss best practices for nested list questions, contact your CSM. 

Nested list questions allow you to set up multiple lists of options that are dependent on the answer given from the previous list. For example, a nested list can be used if you want to capture the program area and then more details based on the primary program area chosen. 

Adding a Nested List

  1. Begin adding the question like any other (click Add New Question on the form and select the nested list question type), then give the overall question a label and click Save Question.
  2. Click Add List to build the first list. 
  3. Give this list (Category) a name, add the list items, then click Save Question.
  4. Select one of the options in the first list, then click Add List again.
  5. Build the list that should display if someone selects that option in the first list. Click Save Question when you're done.
  6. You can now select an option in that second level list if another (third level) list should display based on that selection. Or, you can select another option in the first list to build another second level list. 
    • For instance, in the example below we selected "Elementary" in the "Main Education Level Served" (second level) list, then added a third level list named "Key Focus Area for Elementary Education Program." We could also go back to the "Main Program Area" (first level) list, select a different option there, then build a second level list for that option.
    • You can build up to five levels of nested lists. The example below shows three levels.


  • If you share a nested list on another form, you will not be able to delete or edit it.
  • Nested lists cannot be pulled into custom columns.
  • When using branching rules, you can only branch off of the deepest category item in that series.