Skip To Content

Install ArcGIS Maps for SharePoint

The ArcGIS Maps for SharePoint setup program allows you to easily deploy to your SharePoint installation.

ArcGIS Maps for SharePoint is a SharePoint solution that contains the ArcGIS Maps web part, the ArcGIS Maps Locate workflow, the location field, and the ArcGIS Map Search add-in.

  • ArcGIS Maps—Allows you to display and analyze data from SharePoint lists, ArcGIS hosted feature services, and ArcGIS web maps on an interactive map.
  • ArcGIS Maps Locate workflow—Reads specified information from your SharePoint list and generates a new list column containing location information that can be used to plot features on a map.
  • ArcGIS Map Search—Allows you to tag documents and document sets with location-based metadata and search for those items using a map.

After you install the app, you must configure it before it can be used.


  • Installing ArcGIS Maps for SharePoint requires administrative access to SharePoint.
  • You can configure site collections individually using each site collection's site settings, or you can use the SharePoint Central Administration application to batch-configure multiple site collections at once.
  • Installing on a site that previously had a beta version of ArcGIS Maps for SharePoint installed is not recommended. Before installing ArcGIS Maps for SharePoint, disable and remove all components containing the beta software or create a new site.

Included files

The ArcGIS Maps for SharePoint on-premises installation includes the following files.


ArcGIS Map Search is supported only on SharePoint 2013, 2016, and 2019.

  • Setup.exe—Installation program that allows you to deploy ArcGIS Maps for SharePoint to web applications and site collections in your SharePoint farm.
  • ESRI.ArcGIS.Mapping.SharePoint.wsp—SharePoint solution package that contains the ArcGIS Maps for SharePoint features, resources, and configuration files.
  • EnableAnonymousAccess.ps1—PowerShell script that enables anonymous access to SharePoint lists displayed within the ArcGIS Maps app.
  • Documentation—ArcGIS Maps for SharePoint includes a variety of documents to help you install, configure, and get started with the add-ins. It also includes a guide for deploying language packs, and the license agreement.
  • Language resource files—Setup resources for supported languages. To install ArcGIS Maps for SharePoint in a language other than English, you must first install the English software, and then download and install the appropriate language pack.

Install and deploy ArcGIS Maps for SharePoint on-premises


In a multiserver SharePoint farm environment, ArcGIS Maps for SharePoint must be installed on all Web Front End (WFE) SharePoint servers. When joining a new WFE server to an existing SharePoint farm that has ArcGIS Maps for SharePoint already deployed, install the same version of ArcGIS Maps for SharePoint on the new server after joining the farm.

To install and deploy ArcGIS Maps for SharePoint, do the following:

  1. Download and extract the contents of the ArcGIS Maps for SharePoint installation ZIP file to a location on the system where SharePoint is installed.
  2. Double-click the Setup.exe file to begin the installer. The installer performs a series of checks to ensure that the installation will be successful. If a check fails, the installer provides information about the failure.
  3. Once the checks have completed successfully, click Next.
  4. Read the end-user license agreement (EULA). If you agree to the terms of the EULA, check the check box and click Next.
  5. Optionally use the Secure Store Service to secure your ArcGIS Online credentials and click Next.

    If you receive a message that the Secure Store Service has not started, start this service on your SharePoint server (not applicable for SharePoint Foundation). See Supported environments for more information.

  6. Click Next to continue.
  7. Choose whether to install and activate the ArcGIS Maps Refresh Token autorenewal timer job.

    If you have configured your refresh tokens to expire, you can set up ArcGIS Maps for SharePoint to periodically run a SharePoint timer job to automatically renew the refresh tokens before they expire. If your refresh tokens have not been set to expire, you do not need to activate the timer job. It is recommended that you activate the timer job only if your tokens are set to expire. For more information, see Renew ArcGIS credentials.

    Choose one of the following options:

    • Do not activate ArcGIS Maps Refresh Token auto-renewal (default)—Installs the autorenewal feature but does not activate it. The feature exists but will not run automatically.
    • Activate ArcGIS Maps Refresh Token auto-renewal—Installs and activates the autorenewal feature. When the feature is activated, SharePoint creates a timer job that executes the refresh token renewal feature using the default frequency. You can modify the timer job's settings at any time using the SharePoint Central Administration application.
  8. Click Next to continue.
  9. To participate in the Esri User Experience Improvement program, check the Allow Esri to collect information to improve software check box.
  10. Click Next to continue.
  11. Specify the ArcGIS connection URL. Provide the URL to your ArcGIS Online organization or your ArcGIS Enterprise portal instance and click Test.

    If the connection fails, a red x appears next to the URL field. Correct the URL and click Test again. When the connection is valid, the x disappears. Click Next.

    The specified URL will be inherited by all new site collections created under this one. You can change the URL for specific site collections using the configuration options.

  12. Choose the web applications or site collections on which to enable ArcGIS Maps for SharePoint. In the Web Applications / Site Collections tree, each top-level node represents a SharePoint web application, while each child node represents a site collection. In the following example, ArcGIS Maps for SharePoint is targeted for deployment to the selected site collections. Once you have selected the target web applications and site collections, click Next.
    Choose the site collections on which to install

    If you target a web application, the ArcGIS Maps for SharePoint feature is available to all site collections within that web application. Therefore, for site collections that are not checked on this installer page but are within web applications that are checked, the ArcGIS Maps for SharePoint feature is available but not activated.

    Do not deploy ArcGIS Maps for SharePoint on the root site or the app catalog site.

  13. Click Next to continue.

    The setup performs the installation tasks and displays a message when the operation is completed.

  14. Click Next.

    A summary pane appears, listing details of the installation operation.

  15. Click Next to continue.

    The final pane of the installation wizard appears. On this pane, you can optionally choose to batch-configure multiple site collections at the same time, or you can configure an individual site collection. For more information, see Configure ArcGIS Maps for SharePoint.

    • Click Batch Configure to open the batch configuration page in the SharePoint Central Administration application.
    • Click Configure to open the current site collection's configuration page.
  16. Click Close to finish the setup.

When the installation is complete, configure ArcGIS Maps for SharePoint

Install using PowerShell

Use the following PowerShell commands to manually install ArcGIS Maps for SharePoint and ArcGIS Map Search. Be sure to replace the placeholders in angle brackets (<>) with the information from your system.

Install ArcGIS Maps for SharePoint

# Upload solution package to the farm
 -LiteralPath C:\<download location>\ESRI.ArcGIS.Mapping.SharePoint.wsp

# Install the solution to the desired web application
Install-SPSolution ESRI.ArcGIS.Mapping.SharePoint.wsp
 -WebApplication http://<web application name>

# Wait for the solution to complete the install before enabling feature
Start-Sleep 15

# Enable the feature on the given site collection
 -Identity "b432665a-07a6-4cc7-a687-3e1e03e92b9f"
 -URL http://<web application name>/sites/<MySiteCollectionName>

Install ArcGIS Map Search

# Import the app to the desired site collection
$spapp = Import-SPAppPackage
 -Path "C:\<download location>\"
 -Site http://<web application name>/sites/<MySiteCollectionName>
 -Source ObjectModel

# Install the app on the site collection
 -Web http//<web application name>/sites/<MySiteCollectionName>
 -Identity $spapp