Manage standard object sync

By default, all records on an object are synced to StoreConnect. However, if you have a large volume of Salesforce records (such as millions of contacts or accounts), you can select which records get included in the StoreConnect sync process, speeding up processing time.

When enabled for an object, only records you explicitly select for sync will sync — all others are ignored.

:::note This feature applies to standard Salesforce objects only (such as Contact, Account, and Product2). Custom objects always sync all records and are not affected. :::

Configuration sequence for new StoreConnect users

The best time to configure this feature is before your store is created. The ideal sequence is:

1. Install the StoreConnect package.
2. Configure sync for the objects you want to filter (this article).
3. Run StoreConnect Setup.

The initial sync of your Salesforce data into StoreConnect happens during setup. Configuring the sync objects before running setup means only the records you’ve explicitly selected will be included in that first sync — avoiding the need to clean up unwanted records later. Fewer records also means Setup completes faster, so your store is ready to use sooner.

If you configure this feature after setup has already run (that is, after your store setup has been triggered), you will need to carefully prepare your existing records before enabling it, as any records without enable_sync set will be removed from your store.

:::warning Existing StoreConnect users: Enabling this feature on an object with an existing store without first preparing your records can result in data becoming out of sync. Any records you do not explicitly mark enable_sync will stop syncing and will be removed from StoreConnect. :::

How it works

First, you create a custom field in Salesforce. When the field exists on an object, StoreConnect checks its value on each record before generating a sync event:

• Records with the value enable_sync are included in synchronization
• Records with any other value, or no value, are excluded

If the field does not exist on an object, all records for that object sync as before. The feature is fully backward compatible — adding it to one object has no effect on any other.

Decide how to treat existing records

Any record that you want to sync needs to have the enable_sync option set. Existing records do not have this field and won’t be synced. We recommend that you:

• Identify which records you want to enable sync for
• Identify and remove any records you no longer need

Step 1: Add the StoreConnect_sync field

1. In Salesforce, select the gear icon and select Setup.
2. In the Quick Find box, search for Object Manager.
3. Select the standard object you want to filter (for example, Contact).
4. Select Fields & Relationships, then New.

5. Select Text as the field type and select Next.

   :::note Picklist and text area field types are also supported if you prefer a controlled value set or need a longer field. :::

6. Set the Field Label to StoreConnect Sync and confirm the Field Name is automatically set to StoreConnect_Sync.
7. Complete the remaining field settings and select Save.

Once the field exists on the object, opt-in filtering is active immediately for all future sync events on that object.

:::note Person Accounts: If your org uses Person Accounts, you must add the StoreConnect Sync field to both the Account and Contact objects separately. When creating the Account field, do not use the “Available for Person Accounts” option — that creates the field with a __pc suffix on Account, which StoreConnect does not recognise. Create the field as a standard text field on each object so both get the required StoreConnect_Sync__c API name. :::

Step 2: Enable sync on required records

For each record that you want to sync to StoreConnect, set the StoreConnect_Sync__c field value to enable_sync.

You can do this in bulk using:

• Data Loader — update records via CSV export and import
• Salesforce Flow — build a scheduled flow to set the value on matching records
• Reports and List Views — use inline editing or mass update tools

Records where the field is blank or set to any other value will not sync.

:::warning Accounts and Contacts must be enabled together. If you add the StoreConnect_Sync__c field to both Account and Contact, make sure you enable sync on both the Account record and its related Contact records at the same time. If a Contact syncs but its parent Account does not, StoreConnect may create a duplicate account. If an Account syncs but its Contacts do not, StoreConnect may create duplicate contacts. This applies to both business accounts and Person Accounts.

For Person Accounts, see Step 3 for how to automate this with a Flow. :::

Step 3: Keep Person Account and Contact fields in sync (Person Accounts only)

Because a Person Account’s Account and Contact records have separate StoreConnect_Sync__c fields, they can get out of sync — for example if you update one in bulk but not the other. To prevent this, create a record-triggered Flow on Account that automatically mirrors any change to StoreConnect_Sync__c onto the linked Contact record:

1. In Salesforce Setup, open Flow Builder and create a new Record-Triggered Flow.
2. Set the object to Account and the trigger to run when a record is Updated, optimized for Actions and Related Records.
3. Add an entry condition: IsPersonAccount — equals — True.
4. Add a second entry condition: StoreConnect Sync (i.e. StoreConnect_Sync__c) — Is Changed — True.
5. Add an Update Records action:
   • Select Use the account’s Person Contact ID to find records (or relate to the Contact via PersonContactId).
   • Set StoreConnect_Sync__c on the Contact to the value of {!$Record.StoreConnect_Sync__c}.
6. Save and activate the Flow.

Once active, any change to StoreConnect_Sync__c on a Person Account — whether made manually, in bulk via Data Loader, or by another Flow — will automatically be reflected on the linked Contact.

Step 4: Auto-enable sync for store-created records (optional)

When a new customer registers or checks out, you may want those records immediately included in the sync process. You can do this with standard Salesforce field configuration — no Flow required.

Set a formula-based Default Value on the StoreConnect_Sync__c field so that whenever the StoreConnect sync user creates a record, the field is pre-populated with enable_sync:

1. In Salesforce Setup, open Object Manager and select the object (for example, Contact).
2. Select Fields & Relationships and open the StoreConnect Sync field.
3. Select Edit.

4. In the Default Value field, enter the following formula:

   IF($Permission.storeConnect_Sync, "enable_sync", null)

5. Save the field.

This formula evaluates at record creation time. Because only the StoreConnect sync user should hold the storeConnect_Sync custom permission, the field is set to enable_sync only for records that user creates. Records created by other Salesforce users have no default value applied and are treated separately.

When the sync value changes

StoreConnect handles transitions automatically when the StoreConnect_Sync__c value is updated on a record:

Previous value	New value	What happens
Not enable_sync	enable_sync	Record is sent to StoreConnect as a full insert
enable_sync	Not enable_sync	Record is removed from StoreConnect
enable_sync	enable_sync	Normal update sync — only changed fields are sent
Not enable_sync	Not enable_sync	No sync event generated

This means you can add or remove records from sync at any time simply by updating the field value — no manual cleanup required for those records.

Disable sync on a record

To stop selective syncing and return to syncing ALL records on an object, delete the StoreConnect_Sync__c field from that object in Salesforce Setup. All records will resume syncing automatically on their next change.