Layer is not downloaded

If you have problems downloading a layer for offline use, perform these checks:

  • Check the GIS provider. Only ESRI providers are supported when the user of the mobile app is working offline.
  • Verify that the isOffline option is set to True.
  • If the isFileDownload option is used, verify that the .geodatabase or .tpk file is in the correct location on the server, and that the download URI is formatted correctly.
  • Ensure that the offlineUri option is set correctly. If the offlineUri is not used, verfy that the layer's URL is correct.
  • Ensure that the value of the offlineExtent option is specified using geographic coordinates that are consistent with the spatial reference that you are using. You must specify the map coordinates rather than latitude and longitude.
  • Ensure that the content server supports offline sync.
  • If the layer requires authentication, check that the user has entered the authentication credentials. The user may have canceled map login, and then chosen the option not to attempt future logins. If necessary, clear authentication data from the mobile device and attempt the sync again.
  • If the syncFrequency option for the layer is set to Once, the layer will not sync again until offline map data is cleared from the mobile device.
  • If the offlineFilter option is used, ensure that it is correctly formatted.
  • Verify that the layer id is in the showLayers option, not in the layer's URL.
  • For tiled layers, there may be a restriction on the size of the data that can be requested. Check the offlineExtent and offlineLevelsOfDetail to ensure that an appropriate amount of map data is requested.

The mobile app may also show notifications while syncing map data. If you see the notification "Not enabled for geodatabase sync," there are two possible causes:

  • There is a check box in ArcGIS and ArcGIS Server to enable offline sync. Verify that this check box is selected.
  • Verify that the uri does not include the layer id, and that the layer id is included as a showLayers option.

If you see the notification "Token required," there are three possible causes:

  • The layer requires authentication to access, and the user dismissed the authentication dialog.
  • The authentication dialog for the map server was previously dismissed, and the user selected not to ask again. In this case, run "clear authentication data" from the settings, and attempt re-sync.
  • There is more than one account for map data on the same server. This is not currently a supported configuration.

Finally, if you see the notification "ArcGISWebException" or "Job error 500 Failed to create replica," see this article for information:

https://pro.arcgis.com/en/pro-app/tool-reference/tool-errors-and-warnings/001001-010000/tool-errors-and-warnings-00751-00775-000769.htm