Dynamic image module is the last element that’s under Text&Media objects. 


Dynamic Image module makes it possible to connect external images such as photos or concepts to variables in the questionnaire or to hierarchical units in for instance a Mystery Shopping survey. Depending on the selected filters in a StoryTeller dashboard, not only the results will change but also the externally uploaded images (see how to set up the dynamic image module).




The module is built for handling a process with thousands of images that automatically can be connected to different variables and time periods and to support an automated update process in ongoing projects. Due to that the process is complex.


In the end user view images appear depending on what date and optional filters are selected. If the selections generate more than one image a slide show module appears on the page. In the first example image below the selections generate one image only and due to that no slide show view appears. In the bottom image a slide show appears as the selection generates more than one image.





The behavior in the Power Point export depends on the setup of the Dynamic image object. The reason why the behavior is different is due to the slide show logic used online – slide show logic cannot be used in a PowerPoint slide. So depending on the setup one, both or none of the options below are used in the export to Power Point;


  • a screen shot of the slide show view is inserted in the same position as shown online 
  • X number of images are inserted in separate slides, one image per slide.

The setup consists of two main steps;

  • In an administration screen the images are uploaded and mapping rules created so images automatically can be connected to variables
  • In StoryTeller the new Dynamic image object is inserted in the slide and the content is defined.


The below an explanation of the main logic:

  1. An uploaded image can be mapped against multiple variables but within each variable an image can only be mapped to one answer alternative. E.g. an image can be mapped against Sweden in the Country variable and Round 2 in the wave variable.
  2. The mapping is based on the file name. The file name is matched against either the answer alternative name or the answer alternative ID in the selected variable. If a file should be mapped against multiple variables – delimiter logic is used to separate the different parts in the file name. An example of a file name can be: Sweden_Round 2_photo33.png – which makes it possible to connect the image against Sweden in the country variable and Round 2 in the wave variable.
  3. Except mapping to variables each image gets a response date which is used to filter out relevant images in tracking/ongoing projects. The response date must correlate with the response date of all the respondents in the project.
  4. The response date is set on a batch level (a zipped uploaded file) which means that all images in one upload will get the same response date.
  5. An uploaded image can be shown in more than one Dynamic image object in a report. E.g. if the same image should be shown in two different slides or in two different reports it only needs to be uploaded once.