Creates an output layer file (.lyrx) from a map layer. The layer file stores many properties of the input layer such as symbology, labeling, and custom pop-ups.
The map layer that will be saved to disk as a layer file.
Layer; Table View
Output Layer
The output layer file (.lyrx) that will be created.
Layer File
Store Relative Path
(Optional)
Specifies whether the output layer file will store a relative path to the source data stored on disk or an absolute path.
Checked—The output layer file will store a relative path to the source data stored on disk. If the output layer file is moved, its source path will update to where the source data should be in relation to the new path.
Unchecked—The output layer file will store an absolute path to the source data stored on disk. This is the default.
Boolean
Layer Version
(Optional)
Specifies the version of the output layer file.
Legacy:
This parameter is no longer supported. It remains only for the backward compatibility of scripts and models.
Layer files created in a particular release are supported in all minor releases of the same series. For example, a layer file saved in ArcGIS Pro 3.1 can be used in all ArcGIS Pro 3.x releases.
To save a layer and its properties to a different major release of ArcGIS Pro, use the Package Layer tool.
The map layer that will be saved to disk as a layer file.
Layer; Table View
out_layer
The output layer file (.lyrx) that will be created.
Layer File
is_relative_path
(Optional)
Specifies whether the output layer file will store a relative path to the source data stored on disk or an absolute path.
RELATIVE—The output layer file will store a relative path to the source data stored on disk. If the output layer file is moved, its source path will update to where the source data should be in relation to the new path.
ABSOLUTE—The output layer file will store an absolute path to the source data stored on disk. This is the default.
Boolean
version
(Optional)
Specifies the version of the output layer file.
Legacy:
This parameter is no longer supported. It remains only for the backward compatibility of scripts and models.
Layer files created in a particular release are supported in all minor releases of the same series. For example, a layer file saved in ArcGIS Pro 3.1 can be used in all ArcGIS Pro 3.x releases.
To save a layer and its properties to a different major release of ArcGIS Pro, use the Package Layer tool.
CURRENT—The current version. This is the default.
String
Code sample
SaveToLayerFile example 1 (Python window)
The following Python window script demonstrates how to use the SaveToLayerFile function in immediate mode.
SaveToLayerFile example 2 (stand-alone Python script)
The following Python script demonstrates how to use the SaveToLayerFile function in a stand-alone script.
# Description: Save a layer to a file on disk
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/data"
# Set local variables
in_features = "study_quads.shp"
where_clause = '"NAME" = \'LA MESA\''
in_layer = "studyquadsLyr"
out_layer_file = "studyquadsLyr.lyrx"
# Run MakeFeatureLayer
arcpy.management.MakeFeatureLayer(in_features, "study_quads_lyr", where_clause)
# Run SaveToLayerFile
arcpy.management.SaveToLayerFile("study_quads_lyr", out_layer_file, "ABSOLUTE")