Skip To Content

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 connectivity is intermittent or unavailable.

The following apps support taking web maps offline:

Use the links above for information about what configurations each app supports.

Patterns of use

Taking web maps offline requires offline map areas. Offline map areas are created in two ways:

  • 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 Enterprise. 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.

  • 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 creating offline map areas on demand is a more flexible workflow, it puts more responsibility on the mobile user to ensure they are taking 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.

Enable the layers and map for offline use

To take a web map offline, all the layers, including the basemap and reference layers, must be enabled for offline use. You can enable the following types of map layers for offline use:

  • Hosted feature layers
  • ArcGIS Server feature layers
  • Hosted tile layers
  • 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.

Note:

The default Esri basemaps included in your portal are not enabled for offline use. You can take similar basemaps offline by adding an Esri basemap from ArcGIS Online to your web map.

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 the portal.

You can also enable sync when you publish ArcGIS Server feature layers from ArcGIS Pro, or enable sync on the service in ArcGIS Server Manager after publishing.

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 the portal after you publish the layer.

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.

Web maps

After the layers are enabled for offline use, the Offline section appears on the Settings tab of the map's item page with the Enable offline mode toggle button enabled. If you don’t want your map to be taken offline, click off the Enable offline mode toggle button and click Save.

Use an Esri basemap offline

You can take an Esri basemap from ArcGIS Online offline with an ArcGIS Enterprise web map. To do so, you must have an account as a member of an organization in ArcGIS Online.

Note:

When you take an Esri vector basemap offline in an ArcGIS Enterprise web map, the basemap can only be displayed with the default World Street Map style.

Complete the following steps to add an Esri basemap that you can take offline:

  1. In the Tiled Basemaps or Vector Basemaps groups in ArcGIS Online, find the basemap you want to use and open its item page.
  2. On the item page, in the URL section, click Copy next to the text box containing the layer's URL.
  3. Sign in to your ArcGIS Enterprise portal.
  4. From the My Content tab of the content page, click New item.
  5. Click URL, paste the basemap link you copied in step 2 into the text box, and tab out of the text box.

    The service information is retrieved from ArcGIS Online. It is detected to be secure, and the Username and Password text boxes appear below the URL text box.

  6. Choose Store credentials with service item and click Next.
  7. Provide the username and password for your account that is a member of an organization on ArcGIS Online.
  8. Type a title.
  9. Choose a folder in My Content where you want to save the item.
  10. If the portal administrator has configured content categories, click Assign categories and select up to 20 categories to help people find your item.

    You can also start typing a category name to narrow the list of categories.

  11. Optionally, type tags that describe the item.

    Separate the terms with commas (for example, Federal land is considered one tag; Federal, land is considered two tags).

    As you type, you can select any of the suggested tags that appear; suggestions are generated from tags you have added previously.

  12. Provide a summary that describes the basemap.
  13. Click Save.

    The item page for your new item appears.

  14. To make your basemap available across your maps, create a map that uses the new layer as the basemap and share it with your organization's basemap gallery. For details on making the map, see Use your own basemap. For details on sharing it with the basemap gallery, see How do I make a layer available as a basemap in my organization's basemap gallery?
    Note:

    The map that is shared with the organization's basemap gallery should only be used for offline use and not for general map viewing.

  15. Using Map Viewer or Map Viewer Classic, open the map you want to take offline and update it to use the basemap in one of the following ways:
    • If you added the basemap to the basemap gallery, click Basemap, and click your newly created basemap in the basemap gallery.
    • To add the layer as the basemap for only this map in Map Viewer Classic, see Use your own basemap in Choose a basemap (Map Viewer Classic).
    • To add the layer as the basemap for only this map in Map Viewer, see Use a basemap that is not in the gallery in Choose a basemap (Map Viewer).
  16. Save your changes to the map.

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 levels of detail that you request when taking 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 you want to take offline contains a tile layer, the source service definition file, tile package, or vector tile package for the tile layer must exist in the ArcGIS Enterprise portal.

Create, edit, and manage offline map areas

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 ArcGIS Runtime SDK custom apps.

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.

Create an offline map area

You can create up to 16 offline map areas for your web map. The number of offline map areas you create depends on the needs of your organization and its mobile workers. Before creating an offline area, be sure to configure the advanced offline settings for your map. If you modify these settings after you create offline map areas, you must re-create the map's offline areas to use the updated settings.

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.

    If the web map item does not have an Offline section on the Settings tab, the map contains one or more layers that cannot be taken offline.

  3. In the Offline section, ensure that the Enable offline mode toggle button is on.
  4. In the Offline Map Areas section, 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.
  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 any 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 scheduled updates toggle button.

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

  15. Click Save.

    Your 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.

  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.

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 section, ensure that the Enable offline mode toggle button is on.
  3. In the Offline Map Areas section, click Manage Offline Areas.

    The Manage Offline Areas window appears.

  4. If necessary, type part of the offline map area name in the Filter offline areas field to help you find the one to edit.
  5. 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.
  6. Click Save when you finish editing.

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.

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 (domain), 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 details page and click Refresh. This updates the data manually ahead of the next scheduled package update time.

Choose the right offline options for your project

When authoring a map for offline use, you can control how data will be initially downloaded and subsequently synchronized to offline devices by adjusting the advanced offline options. These settings do not affect edits made by users on mobile devices; those are always synchronized back to the original data.

Note:

You can configure advanced offline options if your map meets the requirements for offline use, plus the following requirements:

  • There is at least one editable feature layer in the map.
  • All editable feature layers in the map are either hosted feature layers or ArcGIS Server feature services.

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

To adjust the advanced offline settings, complete the following steps:

  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. In the Offline section, ensure that the Enable offline mode toggle button is on.
  4. Click Advanced Options.
  5. Under Control feature and attachment delivery, specify how you want to deliver attachments and features to offline devices when the map is downloaded for the first time and each time data updates are synchronized from the map to the device. By default, devices will download and get updates to both features and attachments for editable layers and read-only layers.
    • Under Editable features, choose an option for delivering features and attachments in editable layers. You can deliver both features and attachments, features only, or neither.
    • Under Read-only features, choose an option for delivering features and attachments in read-only layers. You can deliver both features and attachments or features only.
    Tip:

    Choose the options that make sense depending on what users need to see 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 choose to 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 ones.

  6. Under Use a tile package for the offline basemap, choose one of the following to specify what should be used as a basemap on offline devices:
    • Device will use the basemap defined by the web map—If you choose this option, the basemap that is currently in the map will be used offline.
    • Device will use a tile package it already has—If you choose this option, 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.
  7. Click Save to save your changes.