This is an archive related to a previous version of ArcGIS Maps for Office. If you need the current version go to http://doc.arcgis.com/en/maps-for-office.

Install Esri Maps for Office

Esri Maps for Office can be installed on a single computer or deployed across an enterprise.

Software requirements

Esri Maps for Officerequires the following:

  • ArcGIS Online organizational account or Portal for ArcGIS organizational account
  • Microsoft Office 2010 or 2013
  • Internet Explorer 9, 10, or 11
  • Microsoft Windows. Supported versions:
    • Windows 7 (32-bit and 64-bit)
    • Windows 8 (32-bit and 64-bit)
    • Windows 8.1 (32-bit and 64-bit)
    • Windows Server 2008 R2
    • Windows Server 2012
    • Windows Server 2012 R2

Install on one computer

Install the Esri Maps for Office add-in for Microsoft Office by running the setup program as described below. If you have an existing version of Esri Maps for Office installed, you can upgrade to the latest version by running the setup for the latest version. All spreadsheets and maps will be automatically upgraded to the current version. When running the setup, the installation wizard indicates whether it is performing an upgrade or an initial installation.

To install Esri Maps for Office on one computer, do the following:

  1. Double-click the setup file to begin the installation.

    The Welcome page of the Esri Maps for Office Setup wizard appears. Click Next to continue.

  2. Read the End-User License Agreement (EULA). If you agree to the EULA, select the I accept the license agreement radio button and click Next.
  3. If your system is missing any of the required software, the System Check page appears. Click Install Prerequisites to install the missing software. Click Next to continue.
  4. On the Product Features page of the installation wizard, specify the Esri Maps for Office features to install.

    By default, Esri Maps for Office will be installed for both Microsoft Excel and Microsoft PowerPoint.

  5. To change the default installation directory, click Browse and specify the new location. Click Next to continue.
  6. Choose how Esri Maps for Office will connect to ArcGIS:

    Choose the way

    Choose one of the following options:

    • ArcGIS Online—This is the default connection to ArcGIS. Choosing this option allows a user with an ArcGIS organizational account to sign-in using their global ArcGIS username and password.
    • My ArcGIS Online Organization—An organization can be configured to allow access to Esri Maps for Office using enterprise logins through an Active Directory Federation Service, Shibboleth, or SimpleSAMLphp. If your organization has been configured this way and you want to use enterprise logins, select this option and provide the full ArcGIS Online organization URL.
    • My ArcGIS Portal—If your organization uses Portal for ArcGIS, choose this option and provide the URL to your Portal for ArcGIS instance. This URL consists of your Portal for ArcGIS server name and your web adapter name. For more details, see Working with Portal. Contact your organization administrator if you are unsure what these values should be. For general information about Portal, see What is Portal for ArcGIS?
  7. Click Next to continue.

    A confirmation window appears. Check the Check for software upgrade check box to automatically verify if a new version of Esri Maps for Office is available.

  8. Click Install to begin the installation.
  9. Click Finish to complete the Esri Maps for Office installation.

Deploy across the enterprise

Large organizations may not want to deploy the Esri Maps for Office add-in to each computer on their network individually. To support large-scale deployments, Esri Maps for Office includes options for installation from the command line. Automated deployment solutions can be built using these command line options. For example, if your organization wants to use Portal for ArcGIS as the default ArcGIS connection, you can set the CONNECT_TO parameter to your Portal for ArcGIS URL. If you use this setting when you deploy across the organization, all computers will use your Portal for ArcGIS.

To install from the command line, do the following:

  1. Open an administrator command line terminal.
    • For Windows versions earlier than Windows 8, click Start > Run, type cmd, and click OK.
    • For Windows 8, press the Windows key on the keyboard and type cmd. Right-click cmd.exe and choose Run as administrator.
  2. Browse to the folder containing the Esri Maps for Office executable file and type the following command:
    EsriMapsForOffice_x86.exe /quiet /msicl "CONNECT_TO=http://www.arcgis.com" /msicl "FallbackToCloudResources=false" /msicl "FORCEINSTALLPREREQ=true" /msicl "CHECKFORSOFTWAREUPGRADE=true" /msicl "FORCEUSERAPPCONFIGUPDATE=false" /msicl "ESRIMAPSWEBROOT=http://la.arcgis.com" /msicl "ESRIMAPSWEBPROXY=/proxy"
    
  3. Press Enter.

The command shown above includes all the available configuration options. Some parameters are mandatory, others are optional. If you do not want to change an optional default configuration, you do not need to include it in your command.

Available options are:

  • CONNECT_TO—This parameter is mandatory. The value for this parameter is either http://www.arcgis.com, the URL to your ArcGIS Online organization, or the URL to your Portal for ArcGIS instance. Change this value to point to the appropriate location.

  • FallbackToCloudResources—This parameter is mandatory. If your organization uses Portal for ArcGIS, the resources must be installed on the same system as the portal. Setting this parameter to true allows users to work with Esri Maps for Office if the resources are not available on your portal and the user has Internet connectivity. The default value is false.

  • FORCEINSTALLPREREQ—The Esri Maps for Office installer checks if required software is installed on the system. If this parameter is set to true, prerequisites are installed before installing Esri Maps for Office. If set to false, the installation process aborts if required software is not found. The default value is true.
  • CHECKFORSOFTWAREUPGRADE—If set to true, the installer verifies if a new version of Esri Maps for Office is available. If you don't want to check for upgrades, set this value to false. The default value is true.
  • FORCEUSERAPPCONFIGUPDATE—When you use Esri Maps for Office for the first time, custom configuration files are written to your roaming directory. These files hold configurations for custom location types, ArcGIS connection settings, and more. These settings are left in place during upgrades to new versions of Esri Maps for Office. To reset these files to the default settings (or the settings specified during the installation), set this parameter to true. By default, this parameter is set to false for silent installations.
  • ESRIMAPSWEBROOT—This parameter specifies the location of the JavaScript files used by Esri Maps for Office. By default, this is set to http://la.arcgis.com when the ArcGIS connection is either http://www.arcgis.com or the URL of your ArcGIS Online organization.

    If your organization uses Portal for ArcGIS version 10.3 or later, the default value is the location on the portal machine where required JavaScript files are written during installation of the Esri Maps for Office resources (see Work with Portal for ArcGIS).

    If your organization uses Portal for ArcGISversion 10.2.2 or earlier, or if your portal is behind a firewall, you may need to host the files on a server on your local network. Follow the instructions to configure Esri Maps for Office in a disconnected environment and use this parameter to point to the files on your local network.

    If your ArcGIS connection is either http://www.arcgis.com, the URL to your ArcGIS Online organization, or the URL to a Portal for ArcGIS instance version 10.3 or later, it is recommended that you use the default parameter value (do not specify this parameter in your command).

  • ESRIMAPSWEBPROXY—Older browsers sometimes need to use a proxy to avoid errors related to Cross Origin Resource Sharing (CORS). Normally, this proxy is hosted by Esri on ArcGIS Online or Portal for ArcGIS and, in most case, you do not need to change the default value. The only time this value should be changed is if Esri Maps for Office will be connecting to Portal for ArcGIS and you want to host the proxy in a custom location. In that case, use this option to point Esri Maps for Office to your custom proxy location.

Uninstall from the command line

To uninstall via the command-line, use the following steps:

  1. Open an administrator command line and run one of the following registry commands to find the Esri Maps for Office product ID:
    • If the OS is 64 bit and Office is 64 bit or if the OS is 32 bit and Office is 32 bit, use the following command:
      reg query "HKEY_LOCAL_MACHINE\SOFTWARE\ESRI\Esri Maps for Office\v3.1" /v "Product Id"
      
    • If the OS is 64 bit and Office is 32 bit, use the following command:
      reg query "HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ESRI\Esri Maps for Office\v3.1" /v "Product Id"
      
  2. Type the following command to uninstall Esri Maps for Office, using the product ID GUID from the previous step:

    msiexec /x {Product Id} /q