HOW TO

Publish a tile package (TPKX file) from ArcGIS Pro to ArcGIS Online

First Published: May 11, 2026
Last Published: June 26, 2026

Summary

This article describes how to upload and publish a tile package (.tpkx) from ArcGIS Pro to ArcGIS Online so that it can be used as a hosted tile layer in Map Viewer.

Procedure

The first section explains how to convert the data to a .tpkx file in ArcGIS Pro. If the data is already a .tpkx file, skip to the Sharing the package section, below.

Converting the data to a .tpkx file

  1. Load the data into a map in ArcGIS Pro.
  2. On the top pane of the project, navigate to Analysis > Tools. 
  3. Look up the Create Map Tile Package tool.
  4. For Input Map, choose Map.
  5. Ensure that the Package for ArcGIS Online | Bing Maps | Google Maps option is checked.
  6. Create a name for the Output File.
  7. Add any desired Summary or Tags, as shown in the next image.

completing the Analysis tool inputs

  1. The tool will not run with any basemaps. Remove any basemaps included with the input map. 
  2. Click Run to complete the tool. The new .tpkx file sappears in the Catalog pane under Folders, as shown in the next image.

the new tile package appears in the Catalog pane

Sharing the package

  1. On the top pane of the project, navigate to Analysis > Tools.
  2. Look up the Share Package tool.
  3. For the Input Package, choose the .tpkx file.
  4. Add any desired Summary or Tags.

completing the Share package tool inputs

  1. Run the tool and wait for it to complete. This tool publishes the package directly to ArcGIS Online.
  2. Navigate to your Content page in ArcGIS Online. Once the tool is completed in ArcGIS Pro, a new item is published as a Tile package (tpkx).

the tile package is published in Pro

  1. View the Items Details page. On the top right, download the tile package. Save it somewhere that where you will remember for the next steps.
  2. Navigate back to the Content page. On the top left, click New Item.
  3. Drag and drop the file you downloaded in Step 7. When going through the steps of publishing this layer, make sure to publish a hosted layer instead of just the package.

publishing the hosted layer

  1. Add any desired Summary or Tags.
  2. Clicking Next publishes the service to ArcGIS Online. It may take some time to publish the tiles.

publishing the tiles

  1. Once the tiles publish, the new tile layer can be viewed in Map Viewer.

Article ID: 000041412

Software:
  • ArcGIS Pro
  • ArcGIS Online

Get support with AI

Resolve your issue quickly with the Esri Support AI Chatbot.

Start chatting now

Discover more on this topic

Get help from ArcGIS experts

Contact technical support

Start chatting now

Go to download options