Configure Survey123 using ArcGIS AppStudio

The source code for both ArcGIS Survey123 Connect and the Survey123 field app is available in ArcGIS AppStudio, Esri's multiplatform mobile app development tool. Using AppStudio, you can configure Survey123 with your own branding and presentation, or even alter the source code to change functionality.

Create an app

The Survey123 source code is only available in ArcGIS AppStudio under an ArcGIS AppStudio Developer Edition license. For information on how to get an AppStudio Developer Edition license, see License AppStudio Developer Edition. Once this license is applied, download AppStudio at the AppStudio resources page. Then, follow these steps to create an app based on Survey123 in AppStudio:

  1. Open ArcGIS AppStudio.
  2. Click the New App button on the toolbar.
  3. From the category tabs at the top of the window, choose Enterprise.
  4. Choose either Survey123 (Template) or Survey123 Connect (Template) from the list, provide a project name in the upper right corner, and click OK.

You now have an app using the source code of either the Survey123 field app or Survey123 Connect.

Customize your app

Once you create your app, you can customize it by changing the app settings. To access these settings for your app, select it in AppStudio and, in the side panel, click Settings. In the opening Details page, you can provide the following properties:

  • Image—This appears as the icon for your app in AppStudio, and on a device when distributed and downloaded as a native app. For best results, this image should be 512x512 pixels in size.
  • Version—This is displayed in the About page for your app.
  • Title—This is displayed when your app starts. This is also the title of the online item for your app.
  • Summary—This is the summary of the online item for your app.
  • Description—This is the description of the online item for your app.
  • Tags—This is a comma-separated list of tags associated with your app's online item.
  • Access and use constraints—This is displayed in the terms of use for your app's online item.
  • Credits—This is displayed in the Credits (Attribution) section of the online item.

The next page in the Settings window uses the name of the app that your app is based on (Survey123 or Survey123 Connect). This tab contains properties specific to altering visual elements of your app.

Customize Survey123

These are the properties available for Survey123. They can also be modified directly in the app's appinfo.json file. If you change any of these properties, click Apply to save them before running your app.

Property

Text color

Background color

Title bar text color

Title bar background color

Font family

JSON name

backgroundTextureImage

companyLogo

companyUrl

formBackgroundColor

startBackgroundColor

startForegroundColor

startOverlayImage

Customize Survey123 Connect

These are the properties available for Survey123 Connect. With the exception of the Twitter tab, they can also be modified directly in the app's appinfo.json file. If you change any of these properties, click Apply to save them before running your app.

Property

Text color

Background color

Title bar text color

Title bar background color

Font family

Property

Consumer key

Consumer secret key

Twitter account

Survey123 Connect uses Twitter's search API to add tweets from your own Twitter account to the Community side panel. You can obtain the consumer keys required to retrieve these tweets; go to http://developer.twitter.com/. For more information on this functionality, see Twitter's developer documentation on application-only authentication.

JSON name

formBackgroundColor

galleryBackgroundColor

startBackgroundColor

startBackgroundImage

startForegroundColor

Distribute your app

For information on how to distribute your app after it has been customized, see Distribute your app in the AppStudio documentation.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.