Add pop-up features to a map (Clickable map objects)

How can I add points/areas to a map that the respondent can click and then respond to further questions on them or view information on them?

When using maps as part of your questionnaire, you can highlight specific places, routes or areas on the map and make them clickable. After clicking one of the objects, the respondent will see a pop-up window with content or questions. These features are called clickable map objects in Maptionnaire.


Set up:

  1. Prepare your data

    The objects that you want to make clickable need to be uploaded to Maptionnaire either in the GeoJSON or shapefile formats. The supported coordinate reference system for GeoJSONs is WGS84 (EPSG:4326) with the latitude and longitude units in decimal degrees. If you want to show different content in each pop-up window, you should save each object as a separate file and upload them to Maptionnaire one-by-one.

    The next step depends on the function of the clickable map object in your questionnaire:

    • If you do not want to collect data related to the location of the features, please move to Step #2.
    • If you want to record data related to the locations of each specific feature (e.g. by asking questions in the pop-ups), you need to make sure that each feature has an ID key. An ID key is any key within the file that is unique to the feature/location. You can determine the ID key that you want to use when you upload the shapefile or GeoJSON to Maptionnaire.

    To find an identifier that can be used as your ID key, access the attribute table of your GeoJSON or shapefile. Remember to save that feature when exporting the file!

  2. Upload your files to Maptionnaire

    Once you have prepared your shapefiles, you need to upload them to the Maps section in Materials. For more information on how to do this, please see this article (for GeoJSONs) or this article (for shapefiles). As stated above, you need to name the ID key in this process.

  3. Add the files to your questionnaire

    After uploading the files to Materials, you can add them to your questionnaire. Go to the Maps tab in the main settings of your questionnaire. Add your GeoJSONs or shapefiles as Map overlays by clicking the text field next to the Map overlays text. A drop-down list with your GeoJSONs/shapefiles should appear. Select them one by one and decide on which pages of the questionnaire they will be shown.  Remember that you also need a basemap on which the features will be layered.

  4. Add the Clickable map object element to the questionnaire page

    Now the GeoJSON/shapefile objects should be visible in your questionnaire, but you still need to make them clickable by activating them. Go to the page of the questionnaire on which you want to feature the clickable map objects. Add the Clickable map objects element from the element library. Select the GeoJSON/shapefil you want to use from the drop-down list that opens by clicking the empty text box below Map layer

  5. Create the content for the pop-up window

    When the respondents click the clickable objects on the map they will see a pop-up window. To activate the pop-up window, click the three dots on the upper right corner of the element. Select Create pop-up and you will be taken to the editing mode of the pop-up window. Add questions and other elements from the element library. For more detailed instructions on creating and editing pop-up windows, please see this article.

  6. Test before launching!

    As always, remember to test your questionnaire before you start collecting data. It's good to check that the response data looks like it should.

Clickable map objects in the results data:

Just like with other map questions, the answers given in the clickable map object pop-up window have their own tab/sheet in the results Excel. The difference is that in a clickable map object sheet, the Index column will instead list the ID of the object. This way you can see what object was clicked by each respondent and what they answered to any questions.

Was this article helpful?
1 out of 1 found this helpful


  • Can you please provide an example of how an ID key looks like or how to create/find it?

    Also, I don't quite understand this pop up message when I tried adding my ESRI shapefile as a clickable map object.

  • Hi, 

    Clickable map layers require an 'ID' column to identify map objects. This column does not have other restrictions other than that it has to be unique. 

    If this value is missing from one or more of the features, Maptionnaire will automatically generate the value in order to have a unique value to each map object. 

  • Hello, I would like to know if it is possible with the "Clickable map objects" feature for respondents to select several entities (by clicking and dragging the mouse for example). And if so, is it possible to have a pop-up window for each group of selected entities?

  • Hi Stéphanie,

    If you have multiple clickable map objects with pop-up questions, then respondents can choose to answer as many of them as they wish. If you want the content of the pop-ups to be different (e.g. a different question each time), then you need to set them up separately (by repeating steps 4-6 in the instructions above for each question). Hope this answers your question! :) 

  • Hello,
    Thank you for your answer. However, it does not exactly answer my question. I would like to know if respondents can select several geographical objects simultaneously for the same answer.
    Thank you in advance

  • Hi,

    Unfortunately that is not possible currently. Clicking a map object does not select it, it just launches the pop-up linked to that object. The pop-up can then have further questions or information.

    Best regards,

    Asta from Maptionnaire Support


Please sign in to leave a comment.