11.2 Packages & Layer Files

11.2 Packages & Layer Files

Geographic Information Systems rely on complex file structures, database connections, cartographic styles, and spatial datasets. Sharing raw GIS project components individually often results in broken data links, missing fonts, or lost symbology rules. To solve these challenges, ArcGIS Pro provides specialized file formats categorized into Layer Files (which store cartographic rules pointing to external data) and Packages (which consolidate project files and physical spatial data into portable single-file containers). Understanding when to use layer definitions versus consolidated data packages is a central focus of the Esri ArcGIS Pro Foundation exam.

---

Overview of Data Packaging & Sharing Containers

ArcGIS Pro containers are engineered for portability, archival storage, and collaboration across networks or offline environments. They can be shared via email, enterprise file shares, network drives, or uploaded directly to ArcGIS Online and ArcGIS Enterprise portals as item types.

+-----------------------------------------------------------------------------------------+
|                                 ARCGIS PRO CONTAINER TYPES                              |
+----------------------------------------------------+------------------------------------+ 
|              DATA POINTERS / DEFINITIONS           |     CONSOLIDATED DATA CONTAINERS   |
| - Layer File (.lyrx)                               | - Project Package (.ppkx)          |
| - Map File (.mapx)                                 | - Map Package (.mpkx)              |
| - Layout File (.pagx)                              | - Layer Package (.lpkx)            |
| * Stores symbology & paths WITHOUT data            | - Tile Package (.tpkx)             |
| * Requires access to original data source          | * Consolidates & embeds physical   |
|                                                    |   datasets inside a single file    |
+----------------------------------------------------+------------------------------------+

---

Project Packages (.ppkx): Complete Environment Archives

A Project Package (.ppkx) is the most comprehensive container in ArcGIS Pro. It consolidates an entire project file (.aprx), including all associated maps, scenes, layouts, charts, custom toolboxes, style libraries, folder connections, and—most importantly—copies of all underlying spatial datasets into a single compressed file.

Key Characteristics & Workflow

• Data Consolidation: When creating a .ppkx file using the Package Project tool, ArcGIS Pro scans every layer across all maps in the project. It copies local file geodatabase feature classes, shapefiles, and raster datasets into a consolidated internal geodatabase embedded within the package.
• Enterprise Data Options: For layers backed by Enterprise Geodatabases (sde connections), the author can choose whether to copy the enterprise data into the package or maintain live references to the enterprise database.
• Use Cases: Archiving completed GIS projects, transferring full work environments to external contractors or auditors, submitting academic assignments, and migrating projects across disconnected air-gapped networks.

---

Map Packages (.mpkx) and Layer Packages (.lpkx)

When sharing specific sub-components of a project rather than the entire workspace, ArcGIS Pro provides targeted packaging formats:

1. Map Packages (.mpkx)

A Map Package (.mpkx) contains a single map or scene document along with all physical datasets referenced by the layers in that map. Unlike a full Project Package, an .mpkx does not include project layouts, multiple maps, or extra project toolboxes. It isolates one specific map composition and packs its supporting data into a portable archive.

2. Layer Packages (.lpkx)

A Layer Package (.lpkx) bundles a layer definition (symbology, labeling, pop-ups) with the actual physical spatial dataset (e.g., feature class, shapefile, raster) into a single file. When another user adds an .lpkx to their map, both the dataset and its exact cartographic formatting are restored simultaneously without requiring access to the author's local network drive.

---

Layer Files (.lyrx): Symbology Without Data

A Layer File (.lyrx) is a JSON-based file that stores the complete visual property definition of a layer without containing any spatial features or attribute tables.

Structural Properties of .lyrx Files

When you right-click a layer in the Contents pane and select Save As Layer File, ArcGIS Pro writes a .lyrx document containing:

• Cartographic renderer settings (Unique Values, Graduated Colors, Unclassed Renderer, Symbol Layers).
• Labeling properties (label classes, Arcade expressions, SQL queries, placement rules).
• Pop-up configurations, field aliases, and field visibility settings.
• Definition queries and scale-dependent visibility thresholds.
• Source Path Pointer: An explicit file path or database connection string referencing the external dataset.

The Broken Data Source Scenario

Because a .lyrx file contains only a reference pointer, transferring a .lyrx file to a colleague who lacks permission or path access to the underlying geodatabase results in a broken data source error. In ArcGIS Pro, broken data sources are flagged with a prominent red exclamation mark (!) next to the layer in the Contents pane.

To repair a broken layer link, users click the red exclamation mark or select Properties > Source > Set Data Source to browse to the correct local or network path of the feature class.

---

Offline Data Packaging & Mobile Workflows

For field operations where mobile devices operate in remote areas without cellular connectivity, ArcGIS Pro provides specialized offline data package formats:

• Tile Packages (.tpkx): Pre-rendered raster tile pyramids compressed into a single compact file using the Compact V2 storage format. .tpkx files provide fast offline basemaps for ArcGIS Field Maps and mobile applications.
• Vector Tile Packages (.vtpkx): Vector tiles packed into a single offline file, delivering scalable offline vector basemaps with minimal file size.
• Mobile Geodatabases (.geodatabase / .sqlite): SQLite-based portable spatial databases designed for offline vector feature editing in mobile applications.

---

Unpacking Packages & Resource Management in ArcGIS Pro

When a user opens or imports a package file (.ppkx, .mpkx, .lpkx) in ArcGIS Pro, the application executes an automated unpacking process:

1. Extraction Destination: By default, packages are extracted into the user's profile directory at C:\Users\<username>\Documents\ArcGIS\Packages\ (or a custom location defined in Options > Options > Share and Download).
2. Path Restoration: ArcGIS Pro automatically extracts the consolidated geodatabases and updates layer data source pointers to point directly to the newly extracted local directory.
3. Catalog Integration: Unpacked contents, including project files and extracted databases, immediately become available in the Catalog pane under Projects or Folder Connections.