Skip To Content

Connecting the ArcGIS Server Services Directory to your portal

The ArcGIS Server Services Directory is a RESTful representation of all the services running on your ArcGIS Server site. One of the links in the Services Directory allows you to preview a service in an Map. You can configure the Services Directory so that this link displays the service in your own portal's map viewer instead of the map viewer.

When the user chooses to view a service with the ArcGIS JavaScript link, the ArcGIS API for JavaScript hosted on is used to view the service. You can configure the Services Directory to use a locally deployed ArcGIS API for JavaScript or the local API installed with your portal.


If you are disconnected from the Internet, you'll need to use a local version of the map viewer and ArcGIS API for JavaScript to allow users to view services using the links.

  1. In a web browser, open the ArcGIS Server Administrator directory and log in with an account that has administrative privileges to the site. The Administrator Directory is typically available through a URL such as If your server is federated with the portal, see Accessing the Administrator Directory on a federated server for more guidance on how to log in.
  2. In the Administrator Directory, click system > handlers > rest > servicesdirectory > edit.
  3. In the URL box, type the URL to your portal's map viewer, for example,
  4. In the Map Text box, type a label for your map viewer URL, for example, Portal for ArcGIS Map.
  5. If you want to use a locally deployed version of the ArcGIS API for JavaScript, modify the following boxes to contain the local URLs.
    • JavaScript API URL


    • JavaScript API SDK URL

      This URL is connected to the Built using the ArcGIS JavaScript API link that appears at the top of the page when you view a service using the ArcGIS JavaScript API. By default, it goes to the online SDK for the ArcGIS API for JavaScript. You can replace this with a link to a locally installed ArcGIS API for JavaScript SDK you obtained from the Esri Downloads page.

    • JavaScript API CSS URL


    • JavaScript API CSS2 URL


  6. Click Save.