Synced Listings

Synced listings automatically track updates made to the mapped product and sync those updates back to the store listing. Any changes to product fields are propagated across mapped listings for all supported channels, ensuring that the store always reflects the most current information.

Before diving into synced listings, review topics on:

• Manual Listings
• Listing Attribute Mapping
• Listing - Product Mapping

The opposite of synced listings is manual listings. Manual listings also use attribute mapping to prefill listing attributes, but only when first creating the listings. After publishing, changes made to mapped product fields are not automatically reflected in the listings.

Synced listings have two advantages over manual listings:

• Update a single product field, and have those changes automatically propagated to all mapped listings across all channels.
• Update multiple products in bulk using a CSV upload file. This allows you to manage pricing or upload new images for multiple products at once.

Creating and Managing Synced Listings

Before creating synced listings, you need to set up attribute mappings. You don't have to map all possible attributes; you can create a synced listing with as few as one mapped attribute.

The mapped attribute will sync data from the product, while unmapped attributes will require manual input. For example, you might choose to map only the price attribute to sync with price updates on the product. In this case, you will leave all other attributes unmapped.

When filling attributes for synced listings, you cannot manually enter values for synced attributes, as these are drawn from the mapped product fields. You can only enter values for non-mapped attributes.

Creating a New Synced Listing

To create a single new synced listing, follow the steps for creating a new standalone or variation listing. On the New Listing page, select Listing Type: Synced.

To create multiple synced listings in bulk, follow the steps for creating listings in bulk, and select synced as the listing type.

Editing an Existing Synced Listing

To update mapped attributes on a synced listing, make the updates to the corresponding product fields. Shortly after making these updates, the synced listing will automatically be republished with the new information.

Updates undergo a dual approval process, and if they result in missing or invalid data, the listings will be moved to Review.

Deleting a custom field that is mapped to a listing attribute and used in synced listings will leave the mapped attribute empty. This can lead to missing required attributes on synced listings.

To make updates to a synced listing on attributes that are not mapped, follow the same process as you would for editing a manual listing.

Changing Listing Type

You can change the listing type from manual to synced or from synced to manual. When a synced listing is changed to manual, the current synced attribute values become fixed. When a manual listing is changed to synced, the current fixed attribute values are replaced with values from the mapped product fields.

To change the listing type for a single listing, follow these steps:

1. From the sidebar navigation, go to Listings › Listings, and select a listing.
2. On the Status card, click the pencil icon next to Listing Type.
3. Select Manual or Synced, and click Save.

Proceed with caution! You may not realize that some attributes are unintentionally mapped in the store. If those product fields are empty, you will lose all the information entered in listing attributes.

Always be careful when converting published listings to synced, and check shortly thereafter for listings that were placed in Review for invalid or missing information.

All listings within a variation family must share the same listing type, either synced or manual. When you convert one variant from manual to synced, or vice versa, the entire variation family will be converted as well.