Sustainability of Digital Formats: Planning for Library of Congress Collections |
|
| Introduction | Sustainability Factors | Content Categories | Format Descriptions | Contact | |


| Full name | ArcGIS Layer File |
|---|---|
| Description |
ArcGIS Layer Files are proprietary GIS metadata storage files used in Esri products. These files store all settings for Layer file properties. According to Esri, this includes anything that a Layer file can store, including symbology, symbology classifications, labeling properties, scale ranges, feature templates, and definitions. This includes color shading, naming, and label properties. According to Esri, Layer files do not contain geographic data, but rather act as a pointer to a dataset's physical location. Layer Files ensure the same symbology will be displayed on another map. As outlined in the ArcGIS documentation, there are numerous types of layers, and not all of them support the same set of properties. ArcGIS Layer Files are directly readable only by ArcGIS software. ArcGIS Pro offers a Python SDK, arcpy.mp, which can access information about the layers. The ArcGIS documentation outlines, in detail, what Layer files can store. To use an ArcGIS Layer File, the user must also have an associated data file with the same prefix name saved in the same part of the filesystem. ArcGIS Layer Files are defined as having LYRX or LYR as a file extension. While LYR and LYRX files are intended for the same purpose, they are technically distinct from each other. LYRX files are in a JSON-based text format and LYR files are an OLE2-based binary format. ArcGIS Pro can read legacy LYR files but can only save as LYRX files. LYRX files are the extension used in Esri's ArcGIS Pro. LYRX files can store multiple layers and/or multiple group layers at the root level. LYR files are the extension used in Esri's ArcGIS versions 10.X and ArcGIS Desktop. LYR files can only store a single layer or a single group layer at the root level. A group layer can have multiple layers or group layers within it. ArcGIS Layer Files are often found alongside EsriShapefiles. According to North Carolina State University, the Shapefile is considered an industry standard geospatial data format, and widely compatible with other GIS software. Shapefiles comprise of at least three files that must all be saved in the same workspace. In ArcMap, Layer files are created by right-clicking a feature class. In ArcGIS Pro, creating Layer Files depends on if the user is creating individual or group Layer Files. Layers can be referenced from within a project using the listLayers method in the Map or LayerFile class. More information about a layer can be retrieved by inspecting the Describe Object returned by the layer property. |
| Production phase | Designed primarily as a middle-state format and used during production to save and share the state of maps and their properties. |
| Relationship to other formats | |
| Has earlier version | LYR. LYR files are derived from the "OLE2" document container format" family, as seen in North Road's SLYR software LYR sample files. Not described separately on this site at this time. |
| Has extension | Layer Package File (LPK). A layer can also be saved with its data as a layer package. This format is a ZIP package fdd000354). Not described separately on this site at this time. |
| May contain | JSON, JSON (JavaScript Object Notation). LYRX files are JSON-based. |

| LC experience or existing holdings | The Library has many ArcGIS Layer File files in its digital collections especially in the Geography and Map Division - over 160,000 in 2024 - across numerous collections. |
|---|---|
| LC preference | See the Library of Congress Recommended Formats Statement for format preferences for GIS, Geospatial and Non-GIS Cartographic content. |

| Disclosure | Little documentation. Developed and owned by Esri. |
|---|---|
| Documentation |
Limited documentation around the file format itself, with some documentation featuring how to use the format within the context of the applications. Esri publishes a Cartographic Information Model specification on GitHub including the CIMLayerDocument definition used for saving LYRX files. |
| Adoption | For use in ArcMap, ArcGIS, and ArcGIS Pro. |
| Licensing and patents | Software is made by Esri, with no specific licensing or patents for the file format. Comments welcome. |
| Transparency | Used exclusively with Esri software, which requires purchase of a license. This proprietary, commercial software supports Windows, Linux, and cloud-based applications. There is no native macOS support documented by Esri. |
| Self-documentation | LYRX files self-identify within JSON with type, version, and build key:value pairs. The value of "type" will equal "CIMLayerDocument", as seen in sample files shared by the arc2qgis software. LYRX files can be opened and viewed with a text editor. |
| External dependencies | These files work exclusively with ArcMap, ArcGIS, and ArcGIS Pro. File conversion will be required to use with other software platforms, including those not yet built. Layer files saved from ArcGIS Pro cannot be used in ArcMap, according to Esri. There are ways to map files to another format, for example North Road's SLYR tool converts LYR or LYRX files to other formats. |
| Technical protection considerations | None. Comments welcome. |

| Dataset | |
|---|---|
| Support for software interfaces (APIs, etc.) | ArcGIS Pro offers a Python SDK, arcpy.mp, which can be used to access information about the layers. |
| Data documentation (quality, provenance, etc.) | This format holds metadata for use in ArcGIS products. |

| Tag | Value | Note |
|---|---|---|
| Filename extension | lyrx lyr |
ArcGIS Layer Files have an LYR or LYRX extension, as per the documentation. While the extensions are used interchangeably in the documentation, the file formats are distinct. |
| Pronom PUID | See note. | PRONOM has no corresponding entry as of March 2024. |
| Wikidata Title ID | See note. | Wikidata has no corresponding entry as of March 2024. |

| General | |
|---|---|
| History | ArcGIS was first released in 1999 as ARC/INFO, a command line-based GIS tool. This tool was then merged into ArcGIS Desktop, which eventually became ArcGIS Pro. |

|
|