Sustainability of Digital Formats: Planning for Library of Congress Collections

Introduction | Sustainability Factors | Content Categories | Format Descriptions | Contact
Format Description Categories >> Browse Alphabetical List

ArcGIS Layer File

>> Back
Table of Contents
Format Description Properties Explanation of format description terms

Identification and description Explanation of format description terms

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.

Local use Explanation of format description terms

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.

Sustainability factors Explanation of format description terms

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.

Quality and functionality factors Explanation of format description terms

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.

File type signifiers and format identifiers Explanation of format description terms

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.

Notes Explanation of format description terms

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.

Format specifications Explanation of format description terms


Useful references

URLs


Last Updated: 04/19/2024