Map and Scene settings

System administrators can manage many ArcGIS Pro user application settings.

The settings described below should be added under the MapAndScene element in the Pro.settingsConfig file.

Learn more about map and scene options

DefaultBasemapJson

In the user interface, on the Map and Scene tab on the Options dialog box, click Basemap > Map to access the corresponding setting.

Possible values are the following:

  • FromPortal (The default basemap of your organization is added. This is the default.)
  • A JSON object or CIM path corresponding to a custom basemap
  • Not set (An empty string. No basemap is added.)

An example of this setting is shown below.

<DefaultBasemapJson isLocked="true">FromPortal</DefaultBasemapJson>

DefaultSceneBasemapJson

In the user interface, on the Map and Scene tab on the Options dialog box, click Basemap > Scene to access the corresponding setting.

Possible values are the following:

  • FromPortal (The default basemap of your organization is added. This is the default.)
  • A JSON object or CIM path corresponding to a custom basemap
  • Not set (An empty string. No basemap is added.)

An example of this setting is shown below.

<DefaultSceneBasemapJson isLocked="true">FromPortal</DefaultSceneBasemapJson>

LayerVisibleByDefault

In the user interface, on the Map and Scene tab on the Options dialog box, click Add Layer > Make newly added layers visible by default to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

<LayerVisibleByDefault isLocked="true">true</LayerVisibleByDefault>

DefaultSpatialReference

In the user interface, on the Map and Scene tab on the Options dialog box, click Spatial Reference to access the corresponding setting.

Possible values are the following:

  • Not set (An empty string. The spatial reference of the first operational layer is used. This is the default.)
  • A spatial reference .xml file

Note:

Set the default spatial reference through the application and access the location of the user configuration file from the registry key HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Settings\UserConfigLocalRoaming. Within this user configuration file, locate the DefaultSpatialReference setting. Paste this XML inside your administrator setting definition in the Pro.settingsConfig file.

An example of this setting is shown below.

<DefaultSpatialReference isLocked="true">
				&lt;ProjectedCoordinateSystem 
				xsi:type='typens:ProjectedCoordinateSystem' 
				xmlns:xs='http://www.w3.org/2001/XMLSchema' 
				xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' 
				xmlns:typens='http://www.esri.com/schemas/ArcGIS/3.1.0'&gt;&lt;
				WKT&gt;PROJCS["North_Pole_Lambert_Azimuthal_Equal_Area",
				GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",
				SPHEROID["WGS_1984",6378137.0,298.257223563]],
				PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],
				PROJECTION["Lambert_Azimuthal_Equal_Area"],
				PARAMETER["False_Easting",0.0],
				PARAMETER["False_Northing",0.0],
				PARAMETER["Central_Meridian",0.0],
				PARAMETER["Latitude_Of_Origin",90.0],
				UNIT["Meter",1.0],
				AUTHORITY["Esri",102017]]&lt;/WKT&gt;&lt;
				XOrigin&gt;-12742200&lt;/
				XOrigin&gt;&lt;YOrigin&gt;-12742200&lt;/
				YOrigin&gt;&lt;XYScale&gt;10000&lt;/
				XYScale&gt;&lt;ZOrigin&gt;-100000&lt;/
				ZOrigin&gt;&lt;ZScale&gt;10000&lt;/
				ZScale&gt;&lt;MOrigin&gt;-100000&lt;/
				MOrigin&gt;&lt;MScale&gt;10000&lt;/
				MScale&gt;&lt;XYTolerance&gt;0.001&lt;/
				XYTolerance&gt;&lt;ZTolerance&gt;0.001&lt;/
				ZTolerance&gt;&lt;MTolerance&gt;0.001&lt;/
				MTolerance&gt;&lt;HighPrecision&gt;true&lt;/
				HighPrecision&gt;&lt;WKID&gt;102017&lt;/
				WKID&gt;&lt;LatestWKID&gt;102017&lt;/
				LatestWKID&gt;&lt;/
				ProjectedCoordinateSystem&gt;
</DefaultSpatialReference>

ConfirmTransformation

In the user interface, on the Map and Scene tab on the Options dialog box, click Spatial Reference > Warn if transformation between geographic coordinate system is required to align data sources correctly to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

<ConfirmTransformation isLocked="true">true</ConfirmTransformation>

IgnoreBasemapForAutoTransform

In the user interface, on the Map and Scene tab on the Options dialog box, click Spatial Reference > Ignore the extents of basemap layers when listing and automatically choosing transformations to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

<IgnoreBasemapForAutoTransform isLocked="true">true</IgnoreBasemapForAutoTransform>

DefaultLabelEngine

In the user interface, on the Map and Scene tab on the Options dialog box, click Label Engine > Default label engine to access the corresponding setting.

Possible values are the following:

  • Maplex (default)
  • Standard

An example of this setting is shown below.

<DefaultLabelEngine isLocked="true">Standard</DefaultLabelEngine>

AddDefaultElevationSource

In the user interface, on the Map and Scene tab on the Options dialog box, click Ground Elevation Surface to access the corresponding setting.

Possible values are the following:

  • true (A default elevation source is added. This is the default.)
  • false (No elevation source is added.)

An example of this setting is shown below.

<AddDefaultElevationSource isLocked="true">true</AddDefaultElevationSource>

CustomElevationSourceXml

Use this setting if AddDefaultElevationSource is set to true and you are using a custom elevation source. In the user interface, on the Map and Scene tab on the Options dialog box, click Ground Elevation Surface > Default Elevation Source > Use custom elevation source to access the corresponding setting.

Possible values are the following:

  • Not set (An empty string; the default elevation service of your organization is added. This is the default.)
  • A data connection .xml file to a custom elevation source

Note:

Set the default elevation source through the application and access the location of the user configuration file from the registry key HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Settings\UserConfigLocalRoaming. Within this user configuration file, locate the CustomElevationSourceXml setting. Paste this XML inside your administrator setting definition in the Pro.settingsConfig file.

An example of this setting is shown below.

<CustomElevationSourceXml isLocked="true"> 
				&lt;
				CIMStandardDataConnection xsi:type='typens:CIMStandardDataConnection' 
				xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' 
				xmlns:xs='http://www.w3.org/2001/XMLSchema' 
				xmlns:typens='http://www.esri.com/schemas/ArcGIS/3.1.0'&gt;&lt;
				WorkspaceConnectionString&gt;DATABASE=\\[LOCATION]\Elevation&lt;/
				WorkspaceConnectionString&gt;&lt;
				WorkspaceFactory&gt;Raster&lt;/
				WorkspaceFactory&gt;&lt;Dataset&gt;dem30.img&lt;/
				Dataset&gt;&lt;DatasetType&gt;esriDTAny&lt;/
				DatasetType&gt;&lt;/CIMStandardDataConnection&gt;
</CustomElevationSourceXml>

AreUnRegisteredDatasetsAndCsvBackwardCompatible

In the user interface, on the Map and Scene tab on the Options dialog box, click Add Layers and Tables > Query layers and text files > Use field types that are compatible with ArcGIS Pro 3.1 and earlier releases when adding query layers and text files to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

<AreUnRegisteredDatasetsAndCsvBackwardCompatible isLocked="true">false</AreUnRegisteredDatasetsAndCsvBackwardCompatible>

ManageFeatureCaching

In the user interface, on the Map and Scene tab on the Options dialog box, click Feature Cache > Manage feature cache from the Map tab to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

<ManageFeatureCaching isLocked="true">true</ManageFeatureCaching>

CheckMapsWhenDeleting

In the user interface, on the Map and Scene tab on the Options dialog box, click Layer Data Sources > When data sources are deleted: to access the corresponding setting.

Possible values are the following:

  • None—Do not remove map layers when data sources are deleted. This is the default.
  • Open—Remove corresponding layers in open maps when data sources are deleted.
  • All—Remove corresponding layers in all maps when data sources are deleted.

An example of this setting is shown below.

<CheckMapsWhenDeleting isLocked="true">None</CheckMapsWhenDeleting>

CheckMapsWhenRenaming

In the user interface, on the Map and Scene tab on the Options dialog box, click Layer Data Sources > When data sources are renamed: to access the corresponding setting.

Possible values are the following:

  • None—Do not update map layers when data sources are renamed.
  • Open—Update layers in open maps when data sources are renamed. This is the default.
  • All—Update layers in all maps when data sources are renamed.

An example of this setting is shown below.

<CheckMapsWhenRenaming isLocked="true">None</CheckMapsWhenRenaming>

ContentsPanePointLegendPatchSizeLimit

In the user interface, on the Map and Scene tab on the Options dialog box, click Contents Pane > Legend patch size limit for point symbols to access the corresponding setting.

Possible values are values between 0 and 1000 pts. The default value is 48.

An example is shown below.

<ContentsPanePointLegendPatchSizeLimit isLocked="true">48</ContentsPanePointLegendPatchSizeLimit>