DevHubSettings

Represents Dev Hub settings.

Parent Type and Manifest Access

This type extends the Metadata metadata type and inherits its fullName field.

In the package manifest, all org settings metadata types are accessed using the Settings name. See Settings for more details.

File Suffix and Directory Location

DevHubSettings values are stored in the DevHub.settings file in the settings folder. The .settings files are different from other named components because there is only one settings file for each settings component.

Version

DevHubSettings are available in API version 47.0 and later.

Fields

Field Name Field Type Description
enableDevOpsCenterGA boolean Indicates whether DevOps Center is enabled: true or false. When enabled, you can install and use the generally available (GA) DevOps Center package in the org.

Available in API version 56.0 and later.

enableDevOpsCenter boolean (Deprecated) Indicates whether DevOps Center beta is enabled: true or false. When enabled, you can install and use the DevOps Center beta package in the org.
enablePackaging2 boolean Indicates whether unlocked and second-generation managed packaging is enabled: true or false.

To enable enablePackaging2, first enable enableScratchOrgManagementPref.

enableScratchOrgManagementPref boolean Indicates whether Dev Hub is enabled: true or false. When enabled, a Dev Hub allows you to create and manage scratch orgs.
enableScratchOrgSnapshotPref boolean Indicates whether Scratch Org Snapshots is enabled: true or false. When enabled, you can create snapshots of a fully configured scratch org. A snapshot is a point-in-time copy of a scratch org that you can use to create additional scratch orgs.

Available in API version 61.0 and later.

enableShapeExportPref boolean Indicates whether Org Shape is enabled: true or false. When enabled, you can create org shapes as the basis for scratch orgs.

Available in API version 55.0 and later.

Declarative Metadata Sample Definition

The following is an example of a DevHubSettings component.

<?xml version="1.0" encoding="UTF-8"?>
<DevHubSettings xmlns="http://soap.sforce.com/2006/04/metadata">
    <enablePackaging2>true</enablePackaging2>
    <enableScratchOrgManagementPref>true</enableScratchOrgManagementPref>
</DevHubSettings>

Wildcard Support in the Manifest File

The wildcard character * (asterisk) in the package.xml manifest file doesn’t apply to metadata types for feature settings. The wildcard applies only when retrieving all settings, not for an individual setting. For details, see Settings. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.