TriggerSetting__mdt
Sobject
global class TriggerSetting__mdt extends SObjectExtends: SObject
Parent configuration for all trigger actions on a single object. Links to an EntityDefinition to identify the SObject, and provides object-level bypass, permission gating, and performance logging controls that cascade to every child Trigger Action record.
Fields
| Field | Description |
|---|---|
| global Boolean ApplyMasking__c | When checked, the trigger dispatcher calls the data masking framework on every before-insert and before-update for this object before any configured TriggerAction handlers run. |
| global Boolean BypassExecution__c | When checked, ALL trigger actions for this object are completely skipped. |
| global Id BypassFeatureFlag__c | Optional. |
| global FeatureFlag__mdt BypassFeatureFlag__r | Optional. |
| global Boolean EnablePerformanceLogging__c | Master switch for performance logging on this object. |
| global String ObjectApiNameOverride__c | Optional text override for the Object Type relationship above. |
| global Decimal PerformanceThresholdMs__c | Object-level performance threshold in milliseconds. |
| global List PostTriggerActions__r | Reciprocal relationship for PostTriggerAction__mdt.TriggerSetting__c. |
| global Id RequiredFeatureFlag__c | Optional. |
| global FeatureFlag__mdt RequiredFeatureFlag__r | Optional. |
| global Id SObjectType__c | EntityDefinition relationship that identifies which SObject this trigger setting governs. |
| global EntityDefinition SObjectType__r | EntityDefinition relationship that identifies which SObject this trigger setting governs. |
| global List TriggerActions__r | Reciprocal relationship for TriggerAction__mdt.TriggerSetting__c. |
| global List ValidationRuleGroups__r | Reciprocal relationship for ValidationRuleGroup__mdt.TriggerSetting__c. |
Field Details
ApplyMasking__c
global Boolean ApplyMasking__cWhen checked, the trigger dispatcher calls the data masking framework on every before-insert and before-update for this object before any configured TriggerAction handlers run. Only fires when the MaskingFramework_Enabled feature flag is on. Defaults to true so objects with a TriggerSetting are masked automatically; uncheck to opt this one object out.
Field Attributes:
| Attribute | Value |
|---|---|
| Data Type | Checkbox |
| Default Value | true |
BypassExecution__c
global Boolean BypassExecution__cWhen checked, ALL trigger actions for this object are completely skipped. This is an object-level kill switch that overrides individual action settings. Unlike permission-based bypasses, this applies unconditionally to all users.
Field Attributes:
| Attribute | Value |
|---|---|
| Data Type | Checkbox |
| Default Value | false |
BypassFeatureFlag__c
global Id BypassFeatureFlag__cOptional. ALL trigger actions for this object are SKIPPED when the Feature Flag is enabled.
Field Attributes:
| Attribute | Value |
|---|---|
| Data Type | FeatureFlag__mdt |
| Required | false |
| Unique | false |
BypassFeatureFlag__r
global FeatureFlag__mdt BypassFeatureFlag__rOptional. ALL trigger actions for this object are SKIPPED when the Feature Flag is enabled.
Field Attributes:
| Attribute | Value |
|---|---|
| Data Type | FeatureFlag__mdt |
| Required | false |
| Unique | false |
EnablePerformanceLogging__c
global Boolean EnablePerformanceLogging__cMaster switch for performance logging on this object. When enabled, execution times are tracked for all child trigger actions and logged when they exceed the threshold. Individual actions can override via Suppress Performance Logging or Force Performance Logging.
Field Attributes:
| Attribute | Value |
|---|---|
| Data Type | Checkbox |
| Default Value | true |
ObjectApiNameOverride__c
global String ObjectApiNameOverride__cOptional text override for the Object Type relationship above. When populated, this value is used as the SObject API name at dispatch time instead of the relationship. Primary use case is Change Data Capture entities (e.g. AccountChangeEvent, Foobar__ChangeEvent), which the platform excludes from the relationship's picklist filter. For CDC rows, populate the Object Type relationship with the source SObject (e.g. Foobar__c) for admin documentation, and this field with the Change Event API name (e.g. Foobar__ChangeEvent). Leave blank for standard objects, custom objects, and platform events — the relationship covers those directly.
Field Attributes:
| Attribute | Value |
|---|---|
| Data Type | Text(255) |
| Required | false |
| Unique | false |
| External ID | false |
PerformanceThresholdMs__c
global Decimal PerformanceThresholdMs__cObject-level performance threshold in milliseconds. Actions on this object are logged when their execution time exceeds this value. Overrides the global threshold. Individual actions can further override with their own threshold. Leave blank to use the global default.
Field Attributes:
| Attribute | Value |
|---|---|
| Data Type | Number(8,0) |
| Required | false |
| Unique | false |
| External ID | false |
PostTriggerActions__r
global List<PostTriggerAction__mdt> PostTriggerActions__rReciprocal relationship for PostTriggerAction__mdt.TriggerSetting__c .
RequiredFeatureFlag__c
global Id RequiredFeatureFlag__cOptional. ALL trigger actions for this object ONLY RUN when the Feature Flag is enabled.
Field Attributes:
| Attribute | Value |
|---|---|
| Data Type | FeatureFlag__mdt |
| Required | false |
| Unique | false |
RequiredFeatureFlag__r
global FeatureFlag__mdt RequiredFeatureFlag__rOptional. ALL trigger actions for this object ONLY RUN when the Feature Flag is enabled.
Field Attributes:
| Attribute | Value |
|---|---|
| Data Type | FeatureFlag__mdt |
| Required | false |
| Unique | false |
SObjectType__c
global Id SObjectType__cEntityDefinition relationship that identifies which SObject this trigger setting governs. Validated by the platform — only real objects can be selected, preventing misconfiguration from typos or deleted objects. Optional when Object API Name Override is populated (the platform's restricted-picklist filter excludes Change Data Capture entities from this relationship; CDC rows use the override instead). A validation rule enforces that at least one of the two is populated.
Field Attributes:
| Attribute | Value |
|---|---|
| Data Type | EntityDefinition |
| Required | false |
| Unique | false |
SObjectType__r
global EntityDefinition SObjectType__rEntityDefinition relationship that identifies which SObject this trigger setting governs. Validated by the platform — only real objects can be selected, preventing misconfiguration from typos or deleted objects. Optional when Object API Name Override is populated (the platform's restricted-picklist filter excludes Change Data Capture entities from this relationship; CDC rows use the override instead). A validation rule enforces that at least one of the two is populated.
Field Attributes:
| Attribute | Value |
|---|---|
| Data Type | EntityDefinition |
| Required | false |
| Unique | false |
TriggerActions__r
global List<TriggerAction__mdt> TriggerActions__rReciprocal relationship for TriggerAction__mdt.TriggerSetting__c .
ValidationRuleGroups__r
global List<ValidationRuleGroup__mdt> ValidationRuleGroups__rReciprocal relationship for ValidationRuleGroup__mdt.TriggerSetting__c .