Skip to main content

Customizing Salsify Field Mapping

Override the default Salsify property names ChannelGuard reads from — useful when your Salsify catalog uses different column names.

ChannelGuard reads product data from Salsify using a set of default property names. If your Salsify catalog uses different names (e.g., "MAP" instead of "Current Year MAP Price"), you can override the mapping per organization so the sync produces complete rows.

Default field map

ChannelGuard Field

Default Salsify Property

Required

Name

Item Title

Yes

SKU

Model #

No

Brand

Brand

No

Category

Category

No

Sub Category

Sub-Category

No

UPC

UPC Code

No

ASIN

Amazon

No

Google Shopping ID

Google Shopping ID

No

MAP Price

Current Year MAP Price

Yes

MSRP

MSRP

No

Status

Status Filter

Yes

Overriding the map

  • Go to Settings → Product Sync → Salsify Field Mapping

  • The form has three groups: Product Identifiers, Pricing, and Flags & Status

  • Enter your organization's Salsify property name in the field for any ChannelGuard field you want to override

  • Required fields (name, mapPrice, status) are starred — they must always resolve to a Salsify property

  • Each input shows the default as a placeholder — leave a field blank to use the default

  • Click Save — the next sync will use your custom mapping

Resetting to defaults

Click Reset to Defaults to clear all overrides and fall back to the baseline map. You'll need to click Save to apply the reset.

Troubleshooting

Sync runs but produces empty or partial rows: your Salsify property names probably don't match the default map. Open the field mapping UI and enter your actual Salsify property names, then rerun the sync.

"Required field cannot be empty" error: the effective map (your overrides merged over the defaults) has an empty value for name, mapPrice, or status. Either restore that field to its default or provide a valid Salsify property name.

Multiple ChannelGuard fields pointing at the same Salsify column: this works — ChannelGuard deduplicates the export property list automatically. You can safely map, for example, both SKU and ID to the same Salsify column.

Did this answer your question?