Application settings available for administrator control

The sections below provide more information on the settings that you can include in the Pro.settingsConfig file. This includes the functional area, the corresponding setting in the user interface (UI), the default value, and a sample.

The sections below are the same groupings used in the Pro.settingsConfig file.

Application settings

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

UseLocalHelp

In the user interface, on the General tab on the Options dialog box, click Help Source to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

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

UseSpellCheck

In the user interface, on the Proofing tab on the Options dialog box, click Enable spell checking to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

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

UseDarkTheme

In the user interface, on the General tab on the Options dialog box, click Application Theme to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

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

Project settings

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

CreateBackup

In the user interface, on the General tab on the Options dialog box, click Project Recovery > Create a backup when the project has unsaved changes to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

<CreateBackup isLocked="true">true</CreateBackup>

BackupIntervalMinutes

In the user interface, on the General tab on the Options dialog box, click Project Recovery > Save a backup after this time interval has elapsed to access the corresponding setting. Use this setting together with the CreateBackup setting.

Possible values are integers representing minutes. The minimum value is 1 and the maximum value is 999.

Note:

The default setting is 5. If isLocked="false" and a value is set, the value is disregarded.

An example of this setting is shown below.

<BackupIntervalMinutes isLocked="true">3</BackupIntervalMinutes>

Local project settings

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

CustomDefaultLocation

In the user interface, on the General tab on the Options dialog box, click Create projects > Project location to access the corresponding setting.

Possible values are any valid folder paths.

Note:

The default option is to save new projects in the default location, which is C:\Users\<username>\Documents\ArcGIS\Projects. If isLocked="false" and a path is specified, the path appears as a suggestion in the Location text box until the user chooses the option to save new projects in a custom location and sets a value.

An example of this setting is shown below.

<LocalProject>
  <CustomDefaultLocation isLocked="true">\\dataserver1\TeamDefaults\Projects</CustomDefaultLocation>
</LocalProject>

CreateProjectInNewFolder

In the user interface, on the General tab on the Options dialog box, click Create projects > Project location > Create a folder for the project to access the corresponding setting. It also corresponds to the Create a folder for this project check box on the New Project dialog box.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

<LocalProject>
  <CreateProjectInNewFolder isLocked="true">false</CreateProjectInNewFolder>
</LocalProject>

HomeFolder

In the user interface, on the Current Settings tab on the Options dialog box, click Home folder to access the corresponding setting.

Possible values are valid folder paths.

Note:

By default, the home folder is the folder in which the project file is stored. If different values are set for the home folder and the project location, the default geodatabase and toolbox are stored in the home folder location (unless there are custom geodatabase and toolbox settings), and the project file is stored in the project location. The home folder value displays only when a project is open.

An example of this setting is shown below.

<LocalProject>
  <HomeFolder isLocked="true">\\dataserver1\TeamDefaults\Output</HomeFolder>
</LocalProject>

DefaultGeodatabase

In the user interface, on the General tab on the Options dialog box, click Create projects > Geodatabase to access the corresponding setting.

Possible values are valid folder paths to a file, mobile, or enterprise geodatabase.

Note:

The default option is to create a default geodatabase for each project. If isLocked="false" and a path is specified, the path appears as a suggestion in the Location text box until the user chooses the option to use the same default geodatabase for all projects and sets a value.

An example of this setting is shown below.

<LocalProject>
  <DefaultGeodatabase isLocked="true">\\dataserver1\TeamDefaults\Data\TeamData.sde</DefaultGeodatabase>
</LocalProject>

DefaultToolbox

In the user interface, on the General tab on the Options dialog box, click Create projects > Toolbox to access the corresponding setting.

Possible values are valid folder paths to a toolbox, Python toolbox, or legacy toolbox.

Note:

The default option is to create a default toolbox for each project. If isLocked="false" and a path is specified, the path appears as a suggestion in the Location text box until the user chooses the option to use the same default toolbox for all projects and sets a value.

An example of this setting is shown below.

<LocalProject>
  <DefaultToolbox isLocked="true">\\dataserver1\TeamDefaults\Tools\TeamTools.atbx</DefaultToolbox>
</LocalProject>

Versioning settings

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

Learn more about settings for versioning

ConnectionDefaultVersioningType

In the user interface, on the Versioning tab on the Options dialog box, click Geodatabase connection properties > Default versioning type to access the corresponding setting.

Possible values are the following:

  • traditional (default)
  • branch

An example of this setting is shown below:

<ConnectionDefaultVersioningType isLocked="true">branch</ConnectionDefaultVersioningType>

ReconcileDefineConflicts

In the user interface, on the Versioning tab on the Options dialog box, click Reconcile > Define conflicts to access the corresponding setting.

Possible values are the following:

  • ByRow
  • ByColumn (default)

An example of this setting is shown below:

<ReconcileDefineConflicts isLocked="true">ByRow</ReconcileDefineConflicts>

ReconcileResolveConflicts

Use this setting if ConnectionDefaultVersioningType is set to traditional. In the user interface, on the Versioning tab on the Options dialog box, click Reconcile > Resolve conflicts (traditional versioning only) to access the corresponding setting.

Possible values are the following:

  • FavorTargetVersion
  • FavorEditVersion (default)

An example of this setting is shown below:

<ReconcileResolveConflicts isLocked="true">FavorTargetVersion</ReconcileResolveConflicts>

ShowReconcileDialog

In the user interface, on the Versioning tab on the Options dialog box, click Reconcile > Display reconcile options to define and resolve conflicts to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below:

<ShowReconcileDialog isLocked="true">true</ShowReconcileDialog>

ShowConflictDialog

In the user interface, on the Versioning tab on the Options dialog box, click Reconcile > Display reconcile conflict dialog to review conflicts to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below:

<ShowConflictDialog isLocked="true">true</ShowConflictDialog>

Map and Scene settings

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

DefaultBasemapJson

In the user interface, on the Map and Scene tab on the Options dialog box, click Basemap 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>

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>

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>

ContentPanePointLegendsPatchSizeLimit

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.

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

Catalog settings

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

EnableIndexing

In the user interface, on the Indexing tab on the Options dialog box, click Create and manage your own index > Index items to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

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

IndexNetworkConnections

In the user interface, on the Indexing tab on the Options dialog box, click Create and manage your own index > Content and schedule > Index project items in these locations > Network locations to access the corresponding setting.

Possible values are the following:

  • true—Network locations are indexed.
  • false (default)—Network locations are not indexed.

An example of this setting is shown below.

<IndexNetworkConnections isLocked="true">true</IndexNetworkConnections>

MetadataCanDeleteGPHistory

In the user interface, on the Metadata tab on the Options dialog box, click Allow geoprocessing history to be deleted from metadata to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

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

MetadataStyle

In the user interface, on the Metadata tab on the Options dialog box, click Metadata style to access the corresponding setting.

Possible values are those that appear in the Metadata Styles drop-down list. These include the following metadata styles that are provided with ArcGIS Pro, and the names of any custom metadata style add-ins that have been installed.

  • FGDC CSDGM Metadata
  • INSPIRE Metadata Directive
  • ISO 19139 Metadata Implementation Specification GML3.2
  • ISO 19139 Metadata Implementation Specification
  • Item Description (default)
  • North American Profile of ISO19115 2003
  • ISO 19115-3 XML Schema Implementation

An example of this setting is shown below.

<MetadataStyle isLocked="true">INSPIRE Metadata Directive</MetadataStyle>

SearchIndexes

In the user interface, on the Indexing tab on the Options dialog box, click Use indexes managed by others to access the corresponding setting.

Possible values are valid folder paths.

Note:

If isLocked="true", the specified path is added to the list of managed indexes. Additional paths can be specified by placing a vertical bar symbol (|) between path names. Specified paths cannot be removed by the user; however, users are not blocked from adding more paths.

An example of this setting is shown below.

<SearchIndexes isLocked="true">\\dataserver1\WorldData_SearchIndex</SearchIndexes>

SkipServerConnections

In the user interface, on the Indexing tab on the Options dialog box, click Create and manage your own index > Content and schedule > Index project items in these locations > Enterprise geodatabases to access the corresponding setting.

Possible values are the following:

  • true (default)—Enterprise geodatabases are not indexed.
  • false—Enterprise geodatabases are indexed.

An example of this setting is shown below.

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

Navigation settings

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

ShowFlashCrosshairs

In the user interface, on the Navigation tab on the Options dialog box, click Pop-ups > Show crosshairs when flashing to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

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

Selection settings

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

KeepInvisibleFeaturesSelected

In the user interface, on the Selection tab on the Options dialog box, click Keep invisible features selected with a new selection to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

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

Editing settings

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

RequireExplicitStartEditing

In the user interface, on the Editing tab on the Options dialog box, click Session > Enable and disable editing from the Edit tab to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

Note:

This option must be enabled manually before the setting can be locked.

An example of this setting is shown below.

<RequireExplicitStartEditing isLocked="false">false</RequireExplicitStartEditing>

ShowSaveDialog

In the user interface, on the Editing tab on the Options dialog box, click Session > Show dialog to confirm save edits to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

Note:

When this setting is locked with the value set to true, the Don't show this dialog again option on the Save Edits dialog box is disabled.

An example of this setting is shown below.

<ShowSaveDialog isLocked="true">true</ShowSaveDialog>

ShowDiscardDialog

In the user interface, on the Editing tab on the Options dialog box, click Session > Show dialog to confirm discard edits to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

Note:

When this setting is locked with the value set to true, the Don't show this dialog again option on the Discard Edits dialog box is disabled.

An example of this setting is shown below.

<ShowDiscardDialog isLocked="true">true</ShowDiscardDialog>

EnforceAttributeValidation

In the user interface, on the Editing tab on the Options dialog box, click General > Attributes > Enforce attribute validation to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

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

WarnOnDelete

In the user interface, on the Editing tab on the Options dialog box, click General > Productivity > Show dialog to confirm deleting data to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

Note:

When this setting is locked with the value set to true, the Do not show this again option on the Delete dialog box is disabled.

An example of this setting is shown below.

<WarnOnDelete isLocked="true">true</WarnOnDelete>

NewLayersEditable

In the user interface, on the Editing tab on the Options dialog box, click Session > Make newly added layers editable by default to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

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

AutoSaveEdits

In the user interface, on the Editing tab on the Options dialog box, click Session > Automatically Save Edits to access the corresponding setting.

Possible values are the following:

  • time,<integer>, where the integer represents a number of minutes between 1 and 1440. The value defaults to 10 if no integer is specified or if it is outside the range.
  • operation,<integer>, where the integer represents a number of editing operations between 1 and 100. The value defaults to 30 if no integer is specified or if it is outside the range.

Note:

By default, edits are not saved automatically. If isLocked is set to true and either the time or operation setting is specified, edits are saved automatically and the user cannot change the setting or its values. If isLocked is set to true and neither setting is specified, the user cannot save edits automatically.

An example of this setting is shown below.

<AutoSaveEdits isLocked="true">time,1</AutoSaveEdits>

SaveWithProject

In the user interface, on the Editing tab on the Options dialog box, click Session > Save edits when saving project to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

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

WarnOnDiscardAttribute

In the user interface, on the Editing tab on the Options dialog box, click General > Attributes > Uncommitted attribute edits to access the corresponding setting.

Possible values are the following:

  • prompt (default)
  • apply
  • discard

Note:

When this setting is locked with the value set to prompt, the Remember choice and don't show this message again option on the Attributes dialog box is disabled.

An example of this setting is shown below.

<WarnOnDiscardAttribute isLocked="false">apply</WarnOnDiscardAttribute>

WarnOnDiscardGeometry

In the user interface, on the Editing tab on the Options dialog box, click General > Geometry > Uncommitted geometry edits to access the corresponding setting.

Possible values are the following:

  • prompt (default)
  • apply
  • discard

Note:

When this setting is locked with the value set to prompt, the Remember choice and don't show this message again option on the editing tool dialog box is disabled.

An example of this setting is shown below.

<WarnOnDiscardGeometry isLocked="false">prompt</WarnOnDiscardGeometry>

MoveToolActivationAfterPaste

In the user interface, on the Editing tab on the Options dialog box, click General > Productivity > Activate Move tool after all paste operations to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

<MoveToolActivationAfterPaste isLocked="true">true</MoveToolActivationAfterPaste>

AutoApplyAttributes

In the user interface, on the Editing tab on the Options dialog box, click General > Attributes > Auto Apply attribute edits to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

Note:

When this setting is locked, the Auto Apply toggle button in the Attributes pane is disabled.

An example of this setting is shown below.

<AutoApplyAttributes isLocked="true">true</AutoApplyAttributes>

Geoprocessing settings

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

ToolParameters

Use this setting to override the default value of geoprocessing tool parameters. The ToolParameters element should contain one or many Parameter elements, each with the following attributes:

  • toolName—The name of the tool.
  • toolboxAlias—The alias of the toolbox containing the tool.
  • name—The name of the parameter.
  • Islocked—If the parameter value will be locked in the tool dialog box.

Note:

The ToolParameters settings do not have corresponding user interface settings.

The tool name, toolbox alias, and parameter names can be found on each tool's tool reference page, in the Parameters section, on the Python tab.

An example of this setting used to set the Calculate Field tool’s Expression Type (expression_type) parameter default value to Arcade is shown below.

<ToolParameters>
     <Parameter toolName="calculatefield" toolboxAlias="management" name="expression_type" isLocked="true">ARCADE</Parameter>
</ToolParameters>

AddHistoryItem

In the user interface, on the Geoprocessing tab on the Options dialog box, click Logging > Write geoprocessing operations to Geoprocessing History to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

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

AddOutputsToMap

In the user interface, on the Geoprocessing tab on the Options dialog box, click Set options for running geoprocessing tools and scripts > Add output datasets to an open map to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

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

EnableUndo

In the user interface, on the Geoprocessing tab on the Options dialog box, click Set options for running geoprocessing tools and scripts > Enable Undo toggled on by default to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

<EnableUndo isLocked="true">true</EnableUndo>

MessageLevelCommandSyntax

In the user interface, on the Geoprocessing tab on the Options dialog box, click Additional information messages > Command syntax to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

<MessageLevelCommandSyntax isLocked="true">true</MessageLevelCommandSyntax>

MessageLevelDiagnostics

In the user interface, on the Geoprocessing tab on the Options dialog box, click Additional information messages > Diagnostics to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

<MessageLevelDiagnostics isLocked="true">true</MessageLevelDiagnostics>

MessageLevelProjectionTransformation

In the user interface, on the Geoprocessing tab on the Options dialog box, click Additional information messages > Transformations to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

<MessageLevelProjectionTransformation isLocked="true">true</MessageLevelProjectionTransformation>

RecordGPHistoryInMetadata

In the user interface, on the Geoprocessing tab on the Options dialog box, click Logging > Write geoprocessing operations to dataset metadata to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

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

RemoveOverwrittenLayers

In the user interface, on the Geoprocessing tab on the Options dialog box, click Set options for running geoprocessing tools and scripts > Remove layers that reference data overwritten by geoprocessing tools to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

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

Display settings

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

AntialiasingMode

In the user interface, on the Display tab on the Options dialog box, click Set quality and performance options for drawing maps and scenes > Antialiasing mode to access the corresponding setting.

Possible values are the following:

  • None
  • Normal
  • Fast (default)
  • Best

An example of this setting is shown below.

<AntialiasingMode isLocked="true">Normal</AntialiasingMode>

TextAntialiasingMode

In the user interface, on the Display tab on the Options dialog box, click Set quality and performance options for drawing maps and scenes > Text antialiasing mode to access the corresponding setting.

Possible values are the following:

  • None
  • Normal
  • Force (default)

An example of this setting is shown below.

<TextAntialiasingMode isLocked="true">Normal</TextAntialiasingMode>

StereoscopicMode

In the user interface, on the Display tab on the Options dialog box, click Stereoscopic mode to access the corresponding setting.

Possible values are the following:

  • OFF (default)
  • Native (3D shutter glasses)
  • Anaglyph (3D cyan/red glasses)

An example of this setting is shown below.

<StereoscopicMode isLocked="true">Anaglyph</StereoscopicMode>

RenderingMode

In the user interface, on the Display tab on the Options dialog box, click Rendering engine to access the corresponding setting.

Possible values are the following:

An example of this setting is shown below.

<RenderingMode isLocked="true">OpenGL</RenderingMode>

RenderingQuality

In the user interface, on the Display tab on the Options dialog box, click Set quality and performance options for drawing maps and scenes > Rendering quality to access the corresponding setting.

Possible values are the following:

  • 0 (Low.)
  • 1 (Middle.)
  • 2 (High. This is the default.)

An example of this setting is shown below.

<RenderingQuality isLocked="true">1</RenderingQuality>

EnableVSync

In the user interface, on the Display tab on the Options dialog box, click Rendering engine > Enable vertical synchronization to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

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

EnableRenderingAntialiasing

In the user interface, on the Display tab on the Options dialog box, click Rendering engine > Enable hardware antialiasing to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

<EnableRenderingAntialiasing isLocked="true">true</EnableRenderingAntialiasing>

LocalCacheFolderPath

In the user interface, on the Display tab on the Options dialog box, click Local cache to access the corresponding setting.

Possible values are any valid local folder paths.

An example of this setting is shown below.

<LocalCacheFolderPath isLocked="true">C:\Users\<name>\AppData\Local\LocalCaches2</LocalCacheFolderPath>

ClearCacheWhenAppClosing

In the user interface, on the Display tab on the Options dialog box, click Local cache > Clear Cache each time the application closes to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

<ClearCacheWhenAppClosing isLocked="true">true</ClearCacheWhenAppClosing>

UseSquarePrimitive

In the user interface, on the Display tab on the Options dialog box, click Set quality and performance options for drawing maps and scenes > Draw point clouds using squares to improve rendering performance to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

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

Text and Graphics settings

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

DefaultFontName

In the user interface, on the Text and Graphics tab on the Options dialog box, click Default Font > Font name to access the corresponding setting.

Possible values are any valid font family name.

Note:

Set the default font through the application and access the value from the registry key HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Symbology\Settings\DefaultFontName.

An example of this setting is shown below.

<DefaultFontName isLocked="true">Arial Narrow</DefaultFontName>

DefaultFontStyle

In the user interface, on the Text and Graphics tab on the Options dialog box, click Default Font > Font style to access the corresponding setting.

Possible values are any valid font style name.

Note:

Set the default font style through the application and access the value from the registry key HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Symbology\Settings\DefaultFontStyle.

An example of this setting is shown below.

<DefaultFontStyle isLocked="true">Italic</DefaultFontStyle>

DefaultFontVariationSettings

In the user interface, on the Text and Graphics tab on the Options dialog box, click Default Font > Modify variable font axis values to access the corresponding setting.

Note:

This option is only available when a variable font is specified for the default font name. It is locked when the DefaultFontStyle setting is true.

Possible values are any valid axes tag. Examples include the following:

  • wght (weight)
  • wdth (width)
  • slnt (slant)
  • ital (italic)
  • opsz (optical size)
Note:

Set the default font variation settings through the application and access the XML from the registry key HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Symbology\Settings\DefaultFontVariationXml. Paste this XML inside the DefaultFontVariationSettings node of the Pro.settingsConfig file.

An example of this setting is shown below.

<DefaultFontVariationSettings>
  <ArrayOfCIMFontVariation xsi:type='typens:ArrayOfCIMFontVariation' 
    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'>
    <CIMFontVariation xsi:type='typens:CIMFontVariation'><TagName>wght</TagName><Value>300</Value>
    </CIMFontVariation>
    <CIMFontVariation xsi:type='typens:CIMFontVariation'><TagName>wdth</TagName><Value>87</Value>
    </CIMFontVariation>
  </ArrayOfCIMFontVariation>
</DefaultFontVariationSettings>

Color Management settings

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

WorkingColorSpaceForNewItems

In the user interface, on the Color Management tab on the Options dialog box, click Default color model for new items to access the corresponding setting.

Possible values are the following:

  • RGB (default)
  • CMYK

An example of this setting is shown below.

<WorkingColorSpaceForNewItems isLocked="true">CMYK</WorkingColorSpaceForNewItems>

EnableColorManagement

In the user interface, on the Color Management tab on the Options dialog box, click Enable color management to access the corresponding setting.

Possible values are the following:

  • false (default)
  • true

An example of this setting is shown below.

<EnableColorManagement isLocked="true">true</EnableColorManagement>

RGBColorProfile

In the user interface, on the Color Management tab on the Options dialog box, click Color profiles > RGB to access the corresponding setting.

Possible values are the following:

  • sRGB IEC61966-2.1 (default)
  • Any installed RGB color profiles

An example of this setting is shown below.

<RGBColorProfile isLocked="true">sRGB IEC61966-2.1</RGBColorProfile>

CMYKColorProfile

In the user interface, on the Color Management tab on the Options dialog box, click Color profiles > CMYK to access the corresponding setting.

Possible values are the following:

  • U.S. Web Coated (SWOP) v2 (default)
  • Any installed CMYK color profiles

An example of this setting is shown below.

<CMYKColorProfile isLocked="true">U.S. Web Coated (SWOP) v2</CMYKColorProfile>

ColorConversionRule

In the user interface, on the Color Management tab on the Options dialog box, click Conversion rules > Color conversion rule to access the corresponding setting.

Possible values are the following:

  • PreserveColorAppearance (default)
  • PreserveColorValues

An example of this setting is shown below.

<ColorConversionRule isLocked="true">PreserveColorValues</ColorConversionRule>

RenderingIntent

In the user interface, on the Color Management tab on the Options dialog box, click Conversion rules > Rendering intent to access the corresponding setting.

Possible values are the following:

  • RelativeColorimetric (default)
  • Perceptual
  • Saturation
  • AbsoluteColorimetric

An example of this setting is shown below.

<RenderingIntent isLocked="true">Perceptual</RenderingIntent>

EnableDefaultBlackPointCompensation

In the user interface, on the Color Management tab on the Options dialog box, click Conversion rules > Use black point compensation to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

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

Table settings

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

DisableAddRow

In the user interface, on the Table tab on the Options dialog box, click Set options for adding new rows > Hide the 'Click to add new row' option for feature class tables to access the corresponding setting.

Possible values are the following:

  • true
  • false (default)

An example of this setting is shown below.

<DisableAddRow isLocked="true">true</DisableAddRow>

AllowWebLinks

In the user interface, on the Security tab on the Options dialog box, click Allow web links to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

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

SupportedURISchemeList

Use this setting if AllowWebLinks is set to true. In the user interface, on the Security tab on the Options dialog box, click Allow web links > Supported URI schemes to access the corresponding setting.

Many URI schemes are supported. Open the Security options and browse the list to see the available choices. Additional URI schemes can be added.

An example of this setting is shown below.

<SupportedUriSchemeList isLocked="true">ftp,ftps,http</SupportedUriSchemeList>

AllowFileLinks

In the user interface, on the Security tab on the Options dialog box, click Allow file links to access the corresponding setting.

Possible values are the following:

  • true (default)
  • false

An example of this setting is shown below.

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

SupportedFileExtensionList

Use this setting if AllowFileLinks is set to true. In the user interface, on the Security tab on the Options dialog box, click Allow file links > Supported file extensions to access the corresponding setting.

Many file extensions are supported. Open the Security options and browse the list to see the available choices. Additional file extensions can be added.

An example of this setting is shown below.

<SupportedFileExtensionList isLocked="true">.7z,.csv</SupportedFileExtensionList>

FontName

In the user interface, on the Table tab on the Options dialog box, click Set options for table appearance > Table font to access the corresponding setting.

Possible values are those that appear in the Font drop-down list. Segoe UI is the default.

An example of this setting is shown below.

<FontName isLocked="true">Tahoma</FontName>

FontSize

In the user interface, on the Table tab on the Options dialog box, click Set options for table appearance > Table font to access the corresponding setting.

Possible values are the following, which appear in the Size drop-down list:

  • 8
  • 9
  • 10
  • 11 (default)
  • 12
  • 14
  • 16
  • 18
  • 20
  • 22
  • 24
  • 26
  • 28
  • 36
  • 48
  • 72

An example of this setting is shown below.

<FontSize isLocked="true">11</FontSize>

Report settings

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

ReportCustomTemplatePath

In the user interface, on the Report tab on the Options dialog box, click Custom template path to access the corresponding setting.

Possible values are any valid folder paths.

An example of this setting is shown below.

<ReportCustomTemplatePath isLocked="true">C:\Users\<name>\Documents\ArcGIS\ReportTemplates
</ReportCustomTemplatePath>

Layout settings

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

TemplatePath

In the user interface, on the Layout tab on the Options dialog box, click Import gallery path to access the corresponding setting.

Possible values are any valid folder paths.

An example of this setting is shown below.

<TemplatePath isLocked="true">C:\Users\<name>\AppData\Local\ESRI\LayoutTemplates
</TemplatePath>

Share and Download settings

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

StagingPath

In the user interface, on the Share and Download tab on the Options dialog box, click Staging > Stage content for publishing and packaging to this location to access the corresponding setting.

Possible values are any valid folder paths.

Note:

To specify an environment variable in the path, surround it with percent signs (%). For example, enter %USERNAME% to dynamically insert the username of the current user.

An example of this setting is shown below.

<StagingPath isLocked="true">C:\Users\%USERNAME%\AppData\Local\ESRI\ArcGISPro\Staging\SharingProcesses
</StagingPath>

UnpackingProjectPackageOption

In the user interface, on the Share and Download tab on the Options dialog box, click Unpacking > Project Packages and Project Templates to access the corresponding setting.

Possible values are the following:

  • 0 (Unpack to this location. This is the default.)
  • 1 (Ask where to save before unpacking.)

An example of this setting is shown below.

<UnpackingProjectPackageOption isLocked="true">0
</UnpackingProjectPackageOption>

UnpackingProjectPackagePath

Use this setting if UnpackingProjectPackageOption is set to 0. In the user interface, on the Share and Download tab on the Options dialog box, click Unpacking > Project Packages and Project Templates > Unpack to this location to access the corresponding setting.

Possible values are any valid folder paths.

Note:

To specify an environment variable in the path, surround it with percent signs (%). For example, enter %USERNAME% to dynamically insert the username of the current user.

An example of this setting is shown below.

<UnpackingProjectPackagePath isLocked="true">C:\Users\%USERNAME%\Documents\ArcGIS\Packages
</UnpackingProjectPackagePath>

UnpackingOtherPackagesOption

In the user interface, on the Share and Download tab on the Options dialog box, click Unpacking > Other Packages and Files to access the corresponding setting.

Possible values are the following:

  • 0 (Unpack to this location. This is the default.)
  • 1 (Ask where to save before unpacking.)
  • 2 (Unpack to the project's home folder.)

An example of this setting is shown below.

<UnpackingOtherPackagesOption isLocked="true">0</UnpackingOtherPackagesOption>

UnpackingOtherPackagesPath

Use this setting if UnpackingOtherPackagesOption is set to 0. In the user interface, on the Share and Download tab on the Options dialog box, click Unpacking > Other Packages and Files > Unpack to this location to access the corresponding setting.

Possible values are any valid folder paths.

Note:

To specify an environment variable in the path, surround it with percent signs (%). For example, enter %USERNAME% to dynamically insert the username of the current user.

An example of this setting is shown below.

<UnpackingOtherPackagesPath isLocked="false">C:\Users\%USERNAME%\Documents\ArcGIS\Packages
</UnpackingOtherPackagesPath>

OfflineMapsOption

In the user interface, on the Share and Download tab on the Options dialog box, click Offline Maps to access the corresponding setting.

Possible values are the following:

  • 0 (Download maps to this location.)
  • 1 (Ask where to save before unpacking.)
  • 2 (Download maps to the project's home folder. This is the default.)

An example of this setting is shown below.

<OfflineMapsOption isLocked="true">0</OfflineMapsOption>

OfflineMapsPath

Use this setting if OfflineMapsOption is set to 0. In the user interface, on the Share and Download tab on the Options dialog box, click Offline Maps > Download maps to this location to access the corresponding setting.

Possible values are any valid folder paths.

Note:

To specify an environment variable in the path, surround it with percent signs (%). For example, enter %USERNAME% to dynamically insert the username of the current user.

An example of this setting is shown below.

<OfflineMapsPath isLocked="true">C:\Users\%USERNAME%\Documents\ArcGIS\OfflineMaps
</OfflineMapsPath>

MapLayoutPresetsPath

In the user interface, on the Share and Download tab on the Options dialog box, click Map and Layout Presets to access the corresponding setting.

Possible values are any valid folder paths.

Note:

To specify an environment variable in the path, surround it with percent signs (%). For example, enter %USERNAME% to dynamically insert the username of the current user.

An example of this setting is shown below.

<MapLayoutPresetsPath isLocked="false">C:\Users\%USERNAME%\AppData\Roaming\Esri\ArcGISPro\ExportPresets
</MapLayoutPresetsPath>

Authentication settings

The settings below should be added under the Authentication element in the Pro.settingsConfig file. One set of AuthConnection elements is required for each authentication connection you want to manage.

AuthConnection

In the user interface, authentication connections appear on the Authentication tab on the Options dialog box. Each AuthConnection element must include all the elements that correspond to connection properties on the Add Connection dialog box.

An example of this setting for a Microsoft Entra ID connection type is shown below.

<Authentication>
  <AuthConnection isLocked="true">
	   <Name>ConnectionName</Name>
	   <Type>MicrosoftEntraID</Type>
	   <Environment>AzureGlobal</Environment>
	   <TenantID>example.domain.com</TenantID>
           <ClientID>123456789</ClientID>
           <Scopes>
	       <Scope>Scope1</Scope>
	       <Scope>Scope2</Scope>
	   </Scopes> 
  </AuthConnection>
</Authentication>

An example of this setting for a Custom connection type setting is shown below.

<Authentication>
  <AuthConnection isLocked="true">
	   <Name>ConnectionName</Name>
	   <Type>Custom</Type>
	   <AuthorizationURL>example.domain.com/oauth2/authorize</AuthorizationURL>
	   <TokenURL>example.domain.com/oauth2/token</TokenURL>
           <ClientID>123456789</ClientID>
           <Scopes>
	       <Scope>Scope1</Scope>
	       <Scope>Scope2</Scope>
	   </Scopes> 
  </AuthConnection>
</Authentication>

Name

In the user interface, this property corresponds to the Connection Name text box on the Add Connection dialog box.

Possible values are valid connection names. Connection names are limited to 50 characters and cannot contain a backslash ( \ ).

An example of this setting is shown below.

<Name>ConnectionName</Name>

Type

In the user interface, this property corresponds to the Type setting on the Add Connection dialog box.

Possible values are the following:

  • MicrosoftEntraID (Microsoft Entra ID)
  • Custom

An example of this setting is shown below.

<Type>MicrosoftEntraID</Type>

Environment

In the user interface, this property corresponds to the Azure Environment options on the Add Connection dialog box when the Type setting is Microsoft Entra ID.

Possible values are the following:

  • AzureGlobal (Azure)
  • AzureChina (Azure China)
  • AzureUSGovt (Azure US Government)

An example of this setting is shown below.

<Environment>AzureGlobal</Environment>

TenantID

In the user interface, this property corresponds to the Microsoft Entra Domain text box on the Add Connection dialog box when the Type setting is Microsoft Entra ID.

Possible values are Microsoft Entra ID domain names.

An example of this setting is shown below.

<TenantID>example.domain.com</TenantID>

ClientID

In the user interface, this property corresponds to the Client ID text box on the Add Connection dialog box.

Possible values are Client IDs for ArcGIS Pro.

An example of this setting is shown below.

<ClientID>123456789</ClientID>

AuthorizationURL

In the user interface, this property corresponds to the Authorization URL text box on the Add Connection dialog box when the Typesetting is Custom.

Possible values are URLs of the endpoints for obtaining authorization.

An example of this setting is shown below.

<AuthorizationURL>example.domain.com/oauth2/authorize</AuthorizationURL>

TokenURL

In the user interface, this property corresponds to the Token URL text box on the Add Connection dialog box when the Type setting is Custom.

Possible values are URLs of the endpoints for requesting an access token.

An example of this setting is shown below.

<TokenURL>example.domain.com/oauth2/token</TokenURL>

Scopes

In the user interface, this property corresponds to the Scopes text box on the Add Connection dialog box. Scopes are optional. If the Type setting is MicrosoftEntraID and no scope is specified, the scope https://storage.azure.com/.default is added to user machines by default.

Possible values are strings that specify the scope of the access request.

An example of this setting is shown below.

<Scopes>
    <Scope>Scope1</Scope>
    <Scope>Scope2</Scope>
</Scopes>

Geodatabase Replication settings

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

LogFilePath

In the user interface, on the Geodatabase Replication tab on the Options dialog box, this setting corresponds to Log file path.

Possible values are any valid local folder paths.

The path is the location where the ArcGIS Pro replica activity log file is stored. The default location is C:\Users\<username>\AppData\Local\ESRI\ProReplicaActivityLog.dat.

Note:

To specify an environment variable in the path, surround it with percent signs (%). For example, enter %USERNAME% to dynamically insert the username of the current user.

An example of this setting is shown below.

<LogFilePath isLocked="true">C:\Users\%USERNAME%\AppData\Local\ESRI\ProReplicaActivityLog.dat</LogFilePath>

LogLevel

In the user interface, on the Geodatabase Replication tab on the Options dialog box, this setting corresponds to Log level.

Log level options control how much content information is written to the ArcGIS Pro replica activity log file.

Possible values are the following:

  • None—Records no information during the replica creation or synchronization process.
  • Error—Captures only errors during the replica creation or synchronization process.
  • Warning—Captures only warnings during the replica creation or synchronization process.
  • Info: Simple—Captures general replica creation or synchronization process details. This is the default.
  • Info: Standard—Captures slightly more details during the replica creation or synchronization process.
  • Info: Detailed—Captures more details during the replica creation or synchronization process.
  • Debug—Captures the most detail possible during the replica creation or synchronization process.

An example of this setting is shown below.

<LogLevel isLocked="true">Debug</LogLevel>