HomeGuidesAPILog In

Fragment Inputs

Fragment Inputs allow answers and values collected already by the main form to be passed to fragment or data modal projects when they are later presented in the form. The inputs are often used to populate defaults, drive conditions or act as filter values.

In the example below, the user has already indicated their country. That value is then used to drive the states in the data modal.


Fragment Input configuration is the same for Data Modal and Fragment project types.


Note: Both Fragments and Data Modal projects have inputs whereas only fragments have outputs.

Configuring Fragment and Data Modal Project Inputs

  1. In Design, open a Fragment or Data Modal project.

  2. Select All from the toolbox and Drag and Drop an new input onto the Inputs node of the question tree.

  1. Optionally provide a default value. This will be used when the input is not provided by the main form.

  1. Add appropriate references to the inputs.

  2. Save and close your project.

Populating Inputs from the Main Form

  1. Create a new form or open an existing form.

  2. Add the appropriate fragment or data modal.

  3. The available inputs will appear under modal/Fragment inputs as per the project type. Configure the inputs so they source the appropriate values.



If an input is not configured via the Modal/Fragment inputs dialog it will revert to its default value.

  • For Data Modal, go to Question Properties > Modal Inputs.

Sample of Data Modal Inputs

  • For Fragments, go to Fragment Properties > Fragment Inputs.

Sample of Fragment Inputs

  1. Save and close your project.

Repeating Inputs - repeat driven fragments

There is a special kind of input fragments can have call a 'repeating input'. Repeating inputs don't have a data value and instead have the condition 'repeating'. These inputs allows the repetition of a repeating page or section outside the fragment, to induce a repetition of a repeating page of section within the fragment. This is achieved through adding a input to a fragment, enabling the 'Repeating' condition, and using this repeat input to drive a repeating segment with the 'Data Driven' condition enabled.

Within fragment

Within fragment

To then activate this data driven repetition, simply set the fragment input on the form containing the fragment to the repeating section or page you wish the fragment to repeat with.

Main form

Main form

Similarly a repeating output can achieve the same result but flowing out of a fragment into a form or another fragment. You can then use this repeating input - repeating output chain to link together multiple repeating segments.