StoreConnect sync triggers

StoreConnect sync triggers are Apex triggers, automated processes in Salesforce that run whenever records are created, updated, or deleted. They handle the behind-the-scenes work that keeps your storefront and Salesforce data in sync, including:

• Processing media imports and generating CDN URLs
• Recording and publishing record changes for downstream sync
• Assigning system-generated fields (such as unique IDs and composite keys)
• Triggering inventory and stock level adjustments when orders change

When sync triggers are enabled (the default), these processes run automatically in the background. When they are disabled, none of this processing occurs.

:::warning Only disable sync triggers if you have a specific reason to do so, such as a package upgrade or a bulk data load. Leaving triggers disabled will cause media imports, inventory updates, and other background processes to stop working until they are re-enabled. :::

Reasons why sync triggers might be disabled

Sync triggers are occasionally disabled intentionally during maintenance operations, including:

• Package upgrades — to prevent unintended side effects while a new version of StoreConnect is being deployed
• Bulk data loads — to avoid duplicate records or surplus data being created during large imports
• Sandbox refreshes — to prevent data integrity issues while the environment is being reset

In these situations triggers are re-enabled once the operation is complete. If they are not re-enabled, features that depend on background processing, such as media imports, stop working.

Check whether sync triggers are enabled

1. In Salesforce, select the gear icon and select Setup.
2. In the Quick Find box, search for Custom Metadata Types.
3. Select Manage Records next to StoreConnect Setting.
4. Open the record named StoreConnect Triggers Enabled.
5. Read the Setting field value:
   • true — triggers are enabled and running normally, so there is nothing to change
   • false — triggers are disabled, so follow the steps below to re-enable them

Re-enable sync triggers

1. On the StoreConnect Triggers Enabled record, select Edit.
2. Set the Setting field to true.
3. Select Save.
4. Reopen the record and confirm Setting now reads true.
5. Make a small change to a record that depends on trigger processing, such as saving a Media record, and confirm the background processing completes.

:::note Changes to Custom Metadata Types take effect immediately. There is no need to deploy or activate anything after saving. :::

Any records changed while the triggers were disabled did not raise sync events, and re-enabling the triggers does not go back and process them. Save those records again to bring them across.