CommerceSettings

Represents settings for various Commerce features.

Parent Type 

This type extends Metadata and inherits its fields.

Manifest Access 

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

File Suffix and Directory Location 

CommerceSettings values are stored in the Commerce.settings file in the settings folder. The .settings files are different from other named components, because there’s only one settings file for each settings component.

Version 

Commerce Settings are available in API version 50.0 and later.

Special Access Rules 

A B2B Commerce or D2C Commerce license and access to Commerce objects is required.

Fields 

b2CMerchantAgentEnabled 

  • Type: boolean
  • Required: No

buyerGroupExtensibility 

  • Type: boolean
  • Required: No
  • Introduced: API version 64.0
  • Description: Indicates whether Buyer Group Extensibility is enabled (true) or not (false).

commerceAgentTemplateEnabled 

  • Type: boolean
  • Required: No

commerceAnalyticsEnabled 

  • Type: boolean
  • Required: No
  • Description: Indicates whether Commerce Analytics is enabled (true) or not (false).

commerceAppEnabled 

  • Type: boolean
  • Required: No
  • Description: Indicates whether Commerce App is enabled (true) or not (false).

commerceConciergeEnabled 

  • Type: boolean
  • Required: No
  • Description: Indicates whether Commerce Concierge bots are enabled (true) or not (false).

commerceContractPricing 

  • Type: boolean
  • Required: No

commerceCopilotEcomEnabled 

  • Type: boolean
  • Required: No
  • Description: Indicates whether Commerce Copilot is enabled (true) or not (false).

commerceDCSegmentEnabled 

  • Type: boolean
  • Required: No
  • Description: Indicates whether the segment integration is enabled (true) or not (false).

commerceDiscoveryExpansion 

  • Type: boolean
  • Required: No
  • Description: Indicates whether the Commerce Discovery Expansion service is enabled (true) or not (false).

commerceEnabled 

  • Type: boolean
  • Required: No
  • Description: Indicates whether Commerce is enabled (true) or not (false).

commerceHighPrecisionQtyNGP 

  • Type: boolean
  • Required: No

commerceNGPEnabled 

  • Type: boolean
  • Required: No
  • Description: Indicates whether NGP (“Salesforce”) Pricing is enabled (true) or not (false).

commerceProcedurePlan 

  • Type: boolean
  • Required: No

commerceRLMSubs 

  • Type: boolean
  • Required: No
  • Description: Indicates whether Commerce Revenue Lifecycle Management Subscriptions is enabled (true) or not (false).

convCommShopCopilotEnabled 

  • Type: boolean
  • Required: No

conversationalB2CCommerceEnabled 

  • Type: boolean
  • Required: No

enableCheckoutHSOIPref 

  • Type: boolean
  • Required: No

extendCommerceContext 

  • Type: boolean
  • Required: No

externalProductMediaEnabled 

  • Type: boolean
  • Required: No

generateInvPerSubscription 

  • Type: boolean
  • Required: No
  • Introduced: API version 64.0
  • Description: Indicates whether a separate invoice is generated per subscription (true) or not (false).

lowestUnitPriceTracking 

  • Type: boolean
  • Required: No
  • Description: Indicates whether lowest unit price tracking (for EU customers) is enabled (true) or not (false).

messagingEngagementDataKit 

  • Type: boolean
  • Required: No
  • Description: Indicates whether Message Engagement data kit is enabled (true) or not (false). Message Engagement data kit is a data model object (DMO) for a user’s engagement with a marketing message.

Declarative Metadata Sample Definition 

The following is an example of a CommerceSettings component.

1<?xml version="1.0" encoding="UTF-8"?>
2<CommerceSettings xmlns="http://soap.sforce.com/2006/04/metadata">
3	<buyerGroupExtensibility>false</buyerGroupExtensibility>
4	<commerceAnalyticsEnabled>false</commerceAnalyticsEnabled>
5	<commerceAppEnabled>false</commerceAppEnabled>
6	<commerceConciergeEnabled>false</commerceConciergeEnabled>
7	<commerceCopilotEcomEnabled>false</commerceCopilotEcomEnabled>
8	<commerceDCSegmentEnabled>false</commerceDCSegmentEnabled>
9	<commerceDiscoveryExpansion>false</commerceDiscoveryExpansion>
10	<commerceEnabled>false</commerceEnabled>
11	<commerceNGPEnabled>false</commerceNGPEnabled>
12	<commerceRLMSubs>false</commerceRLMSubs>
13	<generateInvPerSubscription>false</generateInvPerSubscription>
14	<lowestUnitPriceTracking>false</lowestUnitPriceTracking>
15	<messagingEngagementDataKit>false</messagingEngagementDataKit>
16</CommerceSettings>

The following is an example package.xml that references the previous definition.

1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3    <types>
4        <members>Commerce</members>
5        <name>Settings</name>
6    </types>
7    <version>64.0</version>
8</Package>

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.