You can create sync properties to keep data consistent across associated records. A sync property will automatically update when its value changes on an associated record, so you won't need to update multiple records manually. A sync property could, for example, automatically sync the value of a company property to its associated contact.
If you have existing workflows that sync property values, learn more about if your workflows could be replaced by sync properties.
Please note: sync properties are read-only and cannot copy data from properties with restricted view and editing access.
Create sync properties
To create a sync property:
- In your HubSpot account, click the settings settings icon in the top navigation bar.
- In the left sidebar menu, navigate to Properties.
- Click Create property.
- Select the property’s object type. This is the object that you want the property to appear on, which has data synced to it (e.g., select Contact to populate the sync property on contact records, or Deal to populate on deal records).
- Enter the property’s other basic information, then click Next.
- For the field type, select Property sync, then click Next.
- Select the source record type. This is the object with the property data will be pulled from. Sync properties are only currently available for 1-to-1 associations between contacts, companies, and deals.
- Select the source record property. This is the property that data will be pulled from.
- If the object relationship has defined association labels, select which associations to consider syncing from:
- All association labels: sync from an associated record regardless of its label.
- Select association labels: sync from an associated record with a specific association label (e.g, Primary to sync data only from the record’s primary company).
- Select the criteria that decides which record to sync data from. This is required if the property considers all associations between the objects or you've selected a label that can be used by many records. To specify which record to sync from, click the Choose which [Object] to sync from dropdown menu, then select an option:
- First created: values will sync from the oldest associated record. For a specific association label, values will sync from the oldest associated record with that label.
- Most recently created: values will sync from the newest associated record. For a specific association label, values will sync from the newest associated record with that label.
- Click Create.
Once you’ve created a sync property, when you set or update the source property, the sync property will also be updated. The sync should occur in less than five seconds, but can take additional time for larger amounts of data.
Migrate from workflows to sync properties
If you've been using workflows to copy property values across objects, in certain scenarios you may be able to replace the workflows with new sync properties.
Sync properties copy data in one direction, relying on a source property (e.g., Company Name on a company record) to copy data into the sync property you create (e.g., Company Name (sync) on a contact record). Depending on the direction of the data you want to sync, you can decide whether or not to replace your workflow with a sync property:
- If you want to update the property value on both sides, you should continue using your existing workflow. Sync properties do not support bi-directional sync.
- If you only want to copy data in one direction, sync properties can replace your workflow.
To migrate from a data sync workflow to using a sync property:
- Create a sync property for the target object. For example, if your workflow syncs data to a contact property, create a contact sync property.
- In your property settings, click the property that the workflow currently syncs data to, then click the Used in tab to understand which tools use the property (e.g. lists, reports, workflows).
- Replace the property in the affected tools with your new sync property. Prior to replacing, it's recommended to clone the assets or processes where the property is used, then add the new sync property to the cloned version to confirm the sync works as expected (e.g., clone a report). For accounts with an Enterprise subscription, you can also test the replacements in a sandbox account.
- Once the sync property has been added to affected tools, turn off your workflow. Don't delete the workflow until the sync works as expected.
- Once your sync property works as expected, you can delete your workflow.