Take web maps offline

ArcGIS supports taking web maps offline. Taking web maps offline allows you to reliably work with your GIS data in disconnected scenarios when network connectivity is intermittent or unavailable.

The following apps support taking web maps offline. Use the links to access information about what configurations each app supports.

Offline map areas

Offline map areas are always used when you take web maps offline. You can either define the offline map area for the map ahead of time, or the client app that downloads the map will define the offline map area on demand.

  • Define an offline map area ahead of time—This pattern is sometimes referred to as a preplanned offline map area.

    As a map author, you can define offline map areas ahead of time for your users. This works well when workers operate in well-defined geographic areas. Whenever possible, it is recommended that you prepare offline map areas ahead of time. Defining offline areas ahead of time has the following benefits over an on-demand workflow:

    • The data for the offline map area is packaged once for all users who need it and hosted in ArcGIS Online. A single offline map area can be downloaded by many users, allowing it to perform better at scale when supporting many offline mobile workers because the data they download has already been packaged.
    • Because the area is defined by the map author, there are minimal errors in the field—such as not enough detail or in the wrong geographic area—when downloading an offline map with layers that have predefined map areas. Taking these decisions out of the control of offline staff members simplifies their workflow and helps them get up and running faster to focus on the work they need to do.

  • Use offline map areas that are created on demand—There are times when it is difficult to predict or know exactly where your mobile staff is going ahead of time. That can be for any number of reasons, including scheduling changes, adjusting to weather, or sudden changes in priority of work. Being able to adapt and be flexible in the field can keep a field team productive.

    This is where an on-demand workflow can help. On-demand offline areas allow a user to define their own area for use offline.

    Although using offline map areas that are created on demand is a more flexible workflow, it puts more responsibility on the mobile user to ensure they take the correct information offline and at the correct level of detail. It can also be more demanding on your organization's resources, because each user's download results in a separate export of the data for their own unique offline area. This pattern is not recommended for large offline crews.

Enabling layers and maps for offline use

To take a web map offline, all the layers, including the basemap and reference layers, must be enabled for offline use.

Esri raster basemaps and Esri vector basemaps are automatically enabled for offline use. The only exception at this time is the Outdoor Esri vector basemap, which cannot be taken offline because it contains a multisource style.

You can enable the following types of map layers for offline use:

  • Hosted feature layers
  • ArcGIS Server feature layers
  • Hosted tile layers (raster or vector)
  • ArcGIS Server cached map services (also called tile layers)—Check the Allow clients to export cache tiles check box when you publish the service from ArcGIS Pro.
  • ArcGIS Server cached image services (also called imagery layers)—Check the Allow clients to export cache tiles check box when you publish the service from ArcGIS Pro.
  • Sketch layers and map note layers saved in the web map

    Note:

    Map note layers that you save as feature collection items and add to a map cannot be taken offline.

Feature layers

Support for offline use of both hosted and ArcGIS Server feature layers requires you to enable synchronization on the layer.

You can enable sync when you publish hosted feature layers, or check the Enable Sync check box on the Settings tab of the hosted feature layer's item page in ArcGIS Online.

You can also enable sync when you publish ArcGIS Server feature layers from a desktop client. The layer owner or site administrator can enable sync on the service in ArcGIS Server Manager after it is published.

Hosted tile layers

When you publish a hosted raster tile layer or hosted vector tile layer from ArcGIS Pro, enable the Allow clients to export cache tiles option. Alternatively, you can enable the Allow this layer to be downloaded and used in an offline map option on the Settings tab of the layer's item page in ArcGIS Online after you publish the layer.

A hosted tile layer can be used as a basemap or as a reference layer in the map.

ArcGIS Server cached map and imagery services

Similar to hosted tile layers, when you publish a cached map service or cached imagery service, you can enable the Allow clients to export cache tiles option in ArcGIS Pro when you publish, or you can enable the Allow this layer to be downloaded and used in an offline map option on the Settings tab of the layer's item page.

A cached map service or imagery service can be used as a basemap or a reference layer.

Sketch layers and map notes layers

Sketch layers and map note layers in web maps are automatically enabled for offline use. However, once the web map is taken offline, sketch and map notes layers do not receive updates if features are added to, deleted from, or modified in the layer in the source map.

Web maps

After the layers are enabled for offline use, go to the Offline section on the Settings tab of the map's item page. Until you enable offline use for the map, the status shown in this section is Offline disabled.

Tip:

If all the reference and basemap layers in the map are enabled for offline use when you create the web map in Map Viewer, the map is enabled for offline use automatically.

If the layers are enabled for offline use after you create the map, follow the steps below to enable the map for use offline:

  1. In the Offline section of the web maps' settings, click Check Compatibility.

    The Check Compatibility window appears.

  2. Enable the Offline toggle button at the top of the window.

    If there are problems in the map, such as if one of the layers in the map is inaccessible, messages appear under the Content section of the Check Compatibility window, and the toggle button will not be enabled. You must correct the problem with the map before you can enable offline use. You must correct all errors before you can enable the map for offline use.

  3. Click Close in the top corner of the Check Compatibility window to close it.

Tips for working with offline maps and layers

Keep the following in mind when you work with offline maps and layers:

  • When taking hosted tile layers, cached map service layers, or cached imagery layers offline, the layers' spatial reference must match the web map's spatial reference. Also, tiles must exist for all tile levels (scales) that you request when taking the map offline. For feature layers, the data is projected to the spatial reference of the web map when you take the map offline.
  • Maps that contain the same hosted or ArcGIS Server feature layer multiple times do not support offline use. For example, you might add the same layer twice and apply a filter or different style to each one. To reference the same data in a web map you take offline, you can do the following:
    • For hosted feature layers, create hosted feature layer views. This provides distinct layers that can be added to the map. Set a view definition and apply different styles as needed.
    • For ArcGIS Server feature layers, publish separate feature services that have unique names. You can then add the feature layers to the same web map to apply filters and styles.
  • Creating offline map areas ahead of time is not supported on feature layers that have ownership-based access control enabled that restricts users from viewing features created by other users.

    For hosted feature layers, ensure that the Editors can see all features option is selected if you enable the Editors can only edit their own features (requires tracking) option on the hosted feature layer item.

    For ArcGIS Server feature layers, the source data in the enterprise geodatabase must have editor tracking enabled, and the service must have at least the Query option checked for the Operations allowed on features created by other users option configured.

  • If the map to be taken offline contains a hosted tile layer, the source service definition file or tile package for the tile layer must exist in ArcGIS Online.
  • You can take ArcGIS tiles offline when using Esri software that supports offline use. Systematically requesting ArcGIS tiles for offline use through other apps or services is prohibited.

Create and manage offline map areas prepared ahead of time

Once you enable a web map for offline use, it's recommended that you create offline map areas to simplify the experience of offline workers. Offline map areas allow you to package data from specific areas of a web map to make it easier and faster to download maps for offline use. Offline map areas that you prepare ahead of time can be used in ArcGIS Field Maps, ArcGIS Survey123, and maps built with ArcGIS Maps SDKs.

When you create an offline map area, the data in the specified area is bundled into one or more downloadable packages. Feature layers are bundled into mobile geodatabase files (.geodatabase), tile layers into tile packages (.tpk or .tpkx), and vector tile layers into vector tile packages (.vtpk). Package names reflect the names of the layers they contain.

To create, edit, and manage offline map areas for a web map, you must be the owner of the map and have privileges to create content.

Note:

You cannot share a web map that contains an offline map area with groups that allow members to update all items, and organization administrators cannot change ownership of a web map that contains an offline map area.

To create an offline map area for a web map that contains a secure public feature service, the service must be from an ArcGIS Server 10.8 or later site.

Create an offline map area

You can create up to 16 offline map areas for a web map. The number of offline map areas you create depends on the needs of your organization and its mobile workers.

Do the following to create an offline map area:

  1. Ensure that all the layers in your map are enabled for offline use.
  2. On the web map's item page, click the Settings tab and click Offline at the top of the tab.
  3. Ensure the map status is Offline enabled. If it is not, enable it now.
  4. Click Manage Offline Areas.

    The Manage Offline Areas window appears.

  5. Click Create offline area.
  6. Do any of the following to navigate to the part of the map where you want to create an offline area.
    • Use the zoom buttons to zoom in or out in the map preview.
    • If your map has bookmarks, click the Show bookmarks button and click a bookmark to navigate to the that area of the map.
    • To navigate to a specific place or address, enter keywords in the search box. Keywords can include addresses, street intersections, places, points of interest, longitude and latitude coordinates, and feature IDs.
  7. To draw a shape representing the offline area, click one of the buttons on the Sketch toolbar.
    • To draw a box around the area to take offline, click the Sketch rectangular map area button Draw rectangle and draw a box on the map.
    • To draw a polygon to define the area you need to take offline, click the Sketch polygon map area button Draw polygon and draw the polygon on the map.

      The map's basemap must be an ArcGIS Online hosted tile layer or a tile layer from an ArcGIS Enterprise 10.7 or later portal; otherwise, the Sketch polygon map area button will be unavailable.

  8. To move the offline area shape, select it and drag it to a new location on the map.
  9. To change the shape of a rectangular area, click the rectangle to select it, hover over a vertex until the pointer changes, and drag the vertex to the desired position. Repeat this action with any of the vertices until you're satisfied with the area of the rectangle.
  10. To change the shape of a polygon area, follow these steps:
    1. Click the polygon to select it and click the Reshape map area button on the Sketch toolbar.

      The polygon's vertices appear.

    2. Click a vertex to select it.
    3. To move a selected vertex, drag it to a new position.
    4. To delete a selected vertex, press the Backspace key on your keyboard.
    5. Repeat substeps b through d with any of the vertices until you're satisfied with the area's shape.
  11. In the Name box, type a descriptive name for the offline map area.
  12. To change the quality and resolution of the downloaded raster or vector tile layers, open the Level of Detail section and move the slider to the right for more detail or to the left for less detail.

    Set a level of detail that is appropriate for the offline map area you create. If the level of detail is too great (for example, you set the level of detail to Streets but your offline map area is the size of Spain), you'll receive a warning indicating you must either reduce the offline map area or decrease the level of detail.

  13. Open the Packaging schedule section to set the interval and time that you want the offline map area packages to be refreshed to capture changes to feature layer data.

    If you don't want to set an automatic refresh schedule, select Never from the drop-down menu.

    Note:

    Scheduled refreshes don't apply to tile layers. You must manually refresh tile layer packages as needed.

  14. To create offline map area packages for read-only use, open the Optimizations section and switch on the Enable packaged updates toggle button.

    Read-only packages are created based on the schedule you set in the previous step.

  15. Click Save.

    The new offline map area appears in the Offline map areas list with a badge indicating the area is being packaged. Packaging can take several seconds or minutes, depending on the size of the data being packaged.

    Packaging for a web layer will fail if the size, when packaged, is larger than 4 GB. For feature layers, packages include all sublayers that are present in the map area. If packaging fails, try sketching a smaller area to include in the offline map package. If the map contains feature layers that have attachments, you can exclude attachments from the offline package to decrease the package size. If the map includes tile layers, you can decrease the size of the offline map area by adjusting the level of detail to include less detail.

  16. To create more offline areas for this map, click Create offline area and repeat the previous steps starting with step 5.

    You can create up to 16 offline map areas per web map.

  17. When you finish defining offline map areas, click Close in the top corner of the Manage Offline Areas window to close it.

Edit an offline map area

Once you have an offline map area, you may want to change its name, shape, level of detail, or the schedule for refreshing feature layer packages (if set).

Do the following to edit an offline map area:

  1. On the web map's item page, click the Settings tab and click Offline at the top of the tab.
  2. In the Offline Map Areas section, click Manage Offline Areas.

    The Manage Offline Areas window appears.

  3. If necessary, type part of the offline map area name in the Filter offline areas field to help you find the one to edit.
  4. Click the name of the offline map area to edit and change any of the settings or the shape of the offline map area as needed.
  5. Click Save when you finish editing.
  6. When you finish editing offline map areas, click Close in the top corner of the Manage Offline Areas window to close it.

Manage offline map areas

In addition to editing your offline map area, you can update or refresh individual packages, and you can re-create or delete offline map area packages at any time. You can also update the map area, which automatically refreshes its associated packages. Understanding each of these options is important to managing your offline map area effectively.

The following actions can be found by selecting existing offline map areas from the list or by clicking an individual offline map area to get to its details.

Update

This is the most common action. Update compares the existing map area packages to the current layers and advanced offline options set on the web map. If layers have been added or removed, clicking Update will delete or add new packages as required. If the advanced offline settings have changed, the Update action also repackages the changed data, and makes the changes available in the offline map area for future users who download it.

The update action does not incorporate schema changes to the map area. For schema changes, re-create the offline map area.

Delete

Deleting an offline map area will remove the offline map area item as well as any associated packages and make the offline map area unavailable for download. Apps that have already downloaded this offline map area can continue to synchronize; however, if the offline area is configured with the Packaged updates option enabled, the offline area will no longer receive updates.

Recreate

Re-creating the offline map area differs from updating the offline map area. When you use the Recreate action, it deletes all packages associated with the map area and re-creates them based on the offline map area's settings.

The primary reason to re-create a map area is to pick up schema changes that have occurred after you created the offline map area. For example, if you add or delete a field or change an attribute value list or range (domains), you must re-create the offline map area to pick up those changes.

Refresh a specific package in a map area

If the data in a feature layer in the offline map changes significantly, and you need to make the updates available for new downloads earlier than the next scheduled offline package update, you can choose the package from the list of packages in the offline map area's page and click Refresh. This updates the data manually ahead of the next scheduled package update time.

Optimize how updates are delivered

You can set a packaging schedule for offline map areas prepared ahead of time to control when or how often updates are available.

Reducing the frequency of data updates sent from the organization to the client can decrease the amount of time it takes to synchronize.

The Enable packaged updates option is available when you set a packaging schedule. This option allows you to optimize how apps working with an offline map area receive updates from the organization. This option works well in the following scenarios:

  • There is no need to edit layers in the offline map.
  • You only need to add features when working offline in custom apps built with ArcGIS Maps SDKs.
  • Mobile staff does not require the most current information.
  • The source data is updated on a well-defined schedule. For example, all parcel data is updated every Friday morning when you receive updates from the assessor's office.

The Enable packaged updates optimization option updates the stored offline map area for the benefit of users who download the offline map for the first time, and also creates separate update packages that contain only changes made since the last run of the packaging schedule. Update packages are used by mobile workers who have already taken the map offline and need only these subsequent changes.

Having a package that contains only the changes made since the last scheduled package update improves performance by reducing the load on your organization's database.

When you enable the Enable packaged updates optimization option for a map area and use the map area in apps that take advantage of this setting, you cannot edit in the offline map (except in the case of apps built with ArcGIS Maps SDKs that support adding features) and you cannot synchronize with the organization to receive updates.

Choosing the right options for offline areas created ahead of time

Understanding how updates are delivered is essential to choosing the right settings for the offline areas you create ahead of time.

Trading scalability for data freshness can be beneficial in many scenarios. The examples below outline the expected behavior for two scenarios: when the data in the map area taken offline can be edited and when the data in the map area taken offline is not editable.

  • Data in the offline map area is editable

    If the map contains at least one editable layer, and the user who takes the map offline has editing privileges, the following is true:

    • Offline map areas prepared ahead of time will update based on the packaging schedule to reduce the staleness of the data for the next user to download.
    • Apps will use sync after the initial download of the map to ensure that the offline map area has the latest available data. This allows the data you're using offline to catch up with the data stored in the organization.
    • Mobile workers can synchronize the offline area whenever they have network connectivity to send and receive updates, ensuring they always have the latest available data.
    • In this scenario, even if you enabled the Enable packaged updates option on the offline map area, it will be ignored and synchronization will be used instead.

  • Data in the offline map area is not editable

    If the map contains no editable layers, or the user who takes the map offline does not have privileges to edit, the following is true:

    • Offline map areas prepared ahead of time will update based on the packaging schedule to reduce the staleness of the data for the next user to download the map area for the first time.
    • New users downloading the offline map area for the first time get the latest available data. What constitutes the latest available data, though, depends on whether you enabled the Enable packaged updates option on the offline map area.
      • If the Enable packaged updates option is enabled, users downloading the map area for the first time receive the latest packaged data available since the last time the packaging schedule was run.
      • If the Enable packaged updates option is not enabled, users downloading the map area for the first time receive the latest data for all the layers in the map that was available at the time they downloaded the map.
    • Mobile workers can check for updates from the mobile app anytime they have connectivity to the organization to receive available updates. What they receive, though, varies depending on the Enable packaged updates setting.
      • If the Enable packaged updates option is enabled, mobile workers receive the latest packaged data available since the last time the packaging schedule was run.
      • If the Enable packaged updates option is not enabled, mobile workers receive the latest data for all the layers in the map that is currently available.

    Note:

    Using packages that contain only the updates made since the last scheduled update improves scalability and performance, but mobile workers may not receive the latest data available for the layers in the map. It is recommended that you align large layer updates as much as possible with your packaging schedule to minimize data staleness if you enable the Enable packaged updates option.

Optimize what data is delivered

Several options are supported to allow you, the map owner, to control what data is delivered to the client, both on the initial download and when synchronizing. When data delivery optimizations are configured for the web map, they apply to offline map areas prepared ahead of time as well as those that are created on demand.

Reducing the amount of data sent from the organization to the client can decrease the amount of time it takes to synchronize, especially in locations with limited network connectivity.

By default, synchronization sends edits from the client app to the organization and from the organization to the client app (bidirectional). These edits include any attachments that are associated with the features with which you are working. That may not be desirable and can increase the amount of data that each user downloads when syncing their map, especially if many workers are operating in the same geographic area and using the same layers.

Feature layer owners and administrators can choose whether you need to see or work with existing features or attachments, and whether you continue getting updates for features or attachments when synchronizing. By adjusting these settings to only deliver the data your mobile workers require, you can reduce the time it takes to synchronize the offline map area and reduce the amount of data being downloaded or synchronized.

Note:

The options configured in the following steps work out of the box in ArcGIS Field Maps. Developers building their own apps with ArcGIS Maps SDKs can take advantage of these advanced options using unsupported JSON. For example, if you're building an app using ArcGIS Maps SDK for .NET, you could use the UnsupportedJson property.

To optimize what data is delivered when a map is taken offline, complete the following steps:

  1. On the web map's item page, click the Settings tab and click Offline at the top of the tab.
  2. In the Offline section, click Options.

    The Options window appears.

  3. In the Features and attachments section, specify how attachments and features are delivered to clients when the offline map is downloaded for the first time and each time data updates are synchronized from the map in the organization to the map on the client. You can configure different settings for editable features and noneditable layers.
    • Features and attachments—This is the default option for both editable and noneditable layers. That means clients will download all features and attachments when the map is downloaded and receive updates to both features and attachments for all layers in the map. You can change the settings for editable and noneditable layers.
    • Features only—Choosing this option excludes attachments when downloading the map and when updates are synchronized from the organization to the client. You can change the settings for editable and noneditable layers.
    • Neither features nor attachments—This option is only available for editable layers. When you choose this option, no editable layers are downloaded or synchronized from the organization to the client.

    Choose the options that make sense depending on what users need to use offline, as well as any concerns or limitations related to device storage, cellular data usage, and download and synchronization speed, especially in areas of poor connectivity. For example, you can deliver only feature updates if offline users don't need to see attachments, or you can have attachments and features delivered for editable layers but not read-only layers.

  4. Click Save in the Features and attachments section to apply changes.
  5. In the Basemap and tile package section, choose one of the following to specify what to use as a basemap in the map when working with it offline:
    • Basemap defined by the web map—The basemap that is currently in the map will be used offline.
    • Tile package on the device—The offline map will use a tile package that is already on the device. Using a tile package as a basemap allows you to download a larger and more detailed basemap for offline use when required. Before choosing this option, ensure the tile package covers the area or areas you plan to work with offline.
    • Tile package from my organization—You will select a tile package item from your organization to use as the basemap in the offline map. In this case, you don't have to load the tile package to all devices that will take the map offline, and ArcGIS Online does not have to compress the map's basemap into a tile package to take it offline.

      Note:

      Users who will take the map offline must have access to the tile package. Ensure that the tile package is shared with the correct audiences to allow offline map users to access it.

  6. Click Save in the Basemap and tile package section to apply changes.
  7. Click the close button Close in the top corner of the Options window to close it.