Dynamically update organization logos in an ArcGIS Survey123 web app survey form

Summary

In ArcGIS Survey123, organization logos can be added to the survey form as an image. Refer to How To: Add an organization logo in an ArcGIS Survey123 survey form for more information.

To update a logo in a survey form, the old image must be replaced in the survey form through ArcGIS Survey123 Connect or the ArcGIS Survey123 web designer, and the survey must be republished.

This article provides two workflows to dynamically update organization logos in the Survey123 web app survey form by adding the image file as an item to ArcGIS Online and inserting the item URL in the survey form. The image in ArcGIS Online can be changed, and the survey form is dynamically updated with the new image without republishing the survey form.

Note:
These workflows do not work for survey forms opened in the Survey123 field app.

Procedure

Dynamically update an organization logo at the top of the survey form in ArcGIS Survey123 web designer

1. Add the logo image file as an item to ArcGIS Online. Refer to ArcGIS Online: Add files as items for more information.
2. On the Overview tab of the image’s item details page, scroll down to URL and click Copy.

3. Insert the URL of the item from ArcGIS Online into the survey form.
   1. Open the survey in the ArcGIS Survey123 web designer.
   2. Click the Design tab and select the header or survey description element in the preview. In this example, the survey header is selected.
   3. On the right panel, click Insert image  and paste the URL copied from ArcGIS Online into the Image URL text box. Refer to ArcGIS Survey123: Use images in a survey for more information.
   4. Click OK.

4. Click Publish, and open the survey in the ArcGIS Survey123 web app to view the image displayed on the survey form. Refer to ArcGIS Survey123: Open a survey for more information.
5. In ArcGIS Online, on the Overview tab of the image’s item details page, click Update Data. Select a new image, making sure the file name is the same as the previous image’s file name.

6. In the ArcGIS Survey123 web app, refresh the page and the image is dynamically updated to the new image from Step 5. To update the image again, repeat the workflow in Step 5.

The image below shows a comparison of the survey header before and after dynamically updating the organization logo.

Dynamically update an organization logo by configuring the survey’s XLSForm in ArcGIS Survey123 Connect

1. Add the image file as an item to ArcGIS Online. Refer to ArcGIS Online: Add files as items for more information.
2. On the Overview tab of the image’s item details page, scroll down to URL and click Copy.

3. Insert the URL of the item from ArcGIS Online into the media::image column of the survey question in ArcGIS Survey123 Connect.
   1. Open the survey’s XLSForm in ArcGIS Survey123 Connect. Paste the URL copied from ArcGIS Online into the media::image column of the question. In this example, the URL is pasted into the note question type at the top of the survey form.

2. Save the XLSForm. In ArcGIS Survey123 Connect, click Publish survey  to publish the survey.
3. Click More actions and click Open in Survey123 web app to view the image displayed on the survey form.

4. In ArcGIS Online, on the Overview tab of the image’s item details page, click Update Data. Select a new image, making sure the file name is the same as the previous image’s file name.

5. In the ArcGIS Survey123 web app, refresh the page and the image is dynamically updated to the new image from Step 4. To update the image again, repeat the workflow in Step 4.

The image below shows a comparison of the top of the survey form before and after dynamically updating the organization logo.