Skip To Content

Include a map in your survey

Survey123 is a form-centric data collection app. The form is the first thing you see when you start your survey. A map is optional. If you want to collect location information in your survey, add a geopoint question to your survey.

When you include a geopoint field, a map is automatically added to your form.

The map is shown on your form as a small thumbnail, but when you click it, it expands to full screen. In full screen mode, you can click on the map to select your location.

Use an online map in your survey

In Survey123 Connect, you can choose which default online basemap is used in your survey. In Survey123, you can change which default online basemap is used while you collect data in your survey. Click the menu on the map page of the survey to change the basemap.

The following default online basemaps are available:

  • World Street Map
  • World Imagery
  • World Topography
  • Light Gray Canvas
  • OpenStreetMap
  • OpenStreetMap Humanitarian
  • OpenCycleMap

Other online maps can be used in Survey123 but must be manually associated to a survey. The online map must contain tile layers. For information on how to publish your own hosted tile layers in ArcGIS, see Publish tiles.

To use your online map in your survey, its URL must be added to the survey's .info file. Currently, there is no user interface item for this, and you must type text directly into the survey's .info file. If you've already uploaded your survey to ArcGIS, you'll already have an .info file you can edit. If you haven't already uploaded your survey to ArcGIS, you can create a new .info file with the following information.

To reference an online map, you must enter a tile template URL. The following are examples of tile template URLs:

  • Google—${x}&y=${y}&z=${z}
  • Open street map—${z}/${x}/${y}.png
  • Esri default basemap—{{z}}/{{y}}/{{x}}.png
  • Esri custom basemap—${z}/${y}/${x}

The following code snippet shows the addition of Google and Esri default online basemaps in a survey's .info file:

    "displayInfo": {
        "map": {
            "mapTypes": {
                "append": false,
                "includeLibrary": false,
                "mapSources": [
                        "name": "Google",
                        "url": "${x}&y=${y}&z=${z}"
                        "name": "Esri dark base map",
                        "url": "${z}/${y}/${x}.png"

For more details on how to edit a survey's .info file, see Prepare basemaps for offline use.

Use an offline map in your survey

You can use an offline map in your survey, but some preparation by the survey creator is required. Offline maps are Esri .tpk files. For additional details, see Prepare basemaps for offline use.

  • Include a basemap in the media folder in your survey's content folder before publishing it. When you open your survey in the Survey123 field app, the .tpk file will be available in your list of basemaps. No additional configuration is required.
  • Sideload a .tpk file—Copy a .tpk file to the ~/ArcGIS/My Surveys/Maps folder to make it available to any survey.
  • Download a .tpk file with your survey—Edit the .info file to include the URL to your .tpk file online. When you open your survey, you'll have the option to download the .tpk file.
  • Browse to an existing .tpk file—You can use any .tpk file that has already been downloaded to your device in your survey. Before opening your survey, ensure that your Map Library Folder is defined. In the Survey123 field app Menu, select Settings, select the Map tab, and select the folder where your maps are saved. Then, in your survey, select your geopoint question to display the full map page. In the map Menu, choose the basemap that is located on your device to display it.


Currently on Windows Phone, you can only download a .tpk file with your survey. You cannot sideload or browse to an existing .tpk file.

For additional details, see Prepare basemaps for offline use.