Continue in the app
Be The First To Get Support Updates
Want to know about the latest technical content and software updates?

How To: Automatically sign in to ArcGIS Survey123 via the app launcher in Portal for ArcGIS


ArcGIS Survey123 can be configured with Portal for ArcGIS to sign in automatically. The App Launcher is a convenient window from which organization members can open web apps available to them. Adding Survey123 to the App Launcher in Portal simplifies frequent user access to the application, eliminating the need to sign in when launching the app.

This article provides instructions to add Survey123 to the App Launcher, so automatic sign-in is allowed when accessed in Portal for ArcGIS.


For this article, a URL is created to use Survey123 with Portal for ArcGIS, and Survey123 is added to the App Launcher in Portal.

  1. Create the URL to use Survey123 with Portal.
    1. Navigate to the Portal homepage and copy the portal URL.
    2. Browse to the following URL and paste the Portal URL in the designated section. The website opens in developer mode, with a message in the top bar showing Portal URL. In this example, the https://survey123.arcgis.com/?portalUrl=https://portal.domain.com/arcgis URL is used.
https://survey123.arcgis.com/?portalUrl=[THE PORTAL URL]
The image of the login page on the ArcGIS Survey123 website.
  1. Sign in to the website with Portal credentials.
  2. Copy the URL from the URL bar.
  1. Sign in to Portal for ArcGIS.
  2. Create a customized Survey123 application using the generated URL.
    1. Navigate to Content > New item and select Application.
    2. In the New item dialog box, select Web mapping for Application type.
    3. Fill in the URL field with the URL from Step 1d. Click Next.
    4. Specify the Title, Tags, and Summary fields. Select the appropriate folder in the Folder field. Click Save.
The image of the New item dialog box to add a new web app.
Alternatively, select Other application for Application type, and click Next. 

Update the data source for the application. Navigate to the application's item details page, and select Settings. Paste the edited URL from Step 1d to the Data Source URL field, and click Save.
Additional configuration is required for Portal for ArcGIS versions 10.4, 10.4.1, and 10.5. Refer to How To: Configure Portal for ArcGIS to work with Survey123 for more information. Additional configuration is not required for versions 10.5.1 and above as these versions are pre-configured to connect to ArcGIS Survey123.
  1. Navigate to Content > My Content. Open the item details page of the application and copy the URL from the URL bar.​
The image of the item details page of the newly created web app.
  1. Navigate to Organization > Settings.
The image of the General page from Settings in ArcGIS Online.
  1. Select the General tab and scroll to the bottom.
  2. Under the App launcher heading, click Add a web app to add the customized Survey123 for ArcGIS application to the app launcher, and click Save. Refer to Portal for ArcGIS: Manage apps in the app launcher for more information.
The image of the App launcher section under Navigation bar in ArcGIS Online.
  1. Click Apps User-added image to access the app launcher, and click the newly added application to navigate to the ArcGIS Survey123 home page without needing to sign in.
The image of the newly created web app being added in the app launcher.

Related Information

Last Published: 6/7/2022

Article ID: 000021099

Software: ArcGIS Survey123 Website Current Portal for ArcGIS 10.7.1, 10.7, 10.6.1, 10.6