How Catalog Sync Works

Layers ensures your product catalog is always current by using Shopify’s robust Webhooks and Bulk Operations. Whenever you create, update, or delete products, these changes are automatically reflected in Layers.

Subscribed Webhooks

Layers listens to the following Shopify Webhooks to maintain synchronization:

  • product/create: Triggers when a new product is added to your Shopify store.
  • product/update: Fires when any changes are made to existing products or their related items like variants or metafields.
  • product/delete: Activates when a product is permanently removed from your Shopify catalog.
  • variants/in_stock: Fires when a variant is restocked in Shopify.
  • variants/out_of_stock: Fires when a variant sells out in Shopify.
  • collections/create: Triggers when a new smart or custom collection is created in Shopify.
  • collections/update: Triggers when smart collection rules or custom collections are updated in Shopify.
  • collections/delete: Fires when a smart or custom collection is deleted from Shopify.
  • orders/create: Fires when an order is created in Shopify.

*Order webhooks are only subscribed to to calculate product and variant level sales metrics. PII is not ingested or retained.

Synced Content

The synchronization includes all active products and variants, as well as associated media that are published to your primary storefront. It also encompasses all Product, Variant, and Shopify’s Standard Product Taxonomy Metafields specified under the Shopify Integration configuration.

Configuring Catalog Sync

To adjust your catalog sync settings:

  1. Navigate to the Setting page on the Layers dashboard.
  2. Select the Shopify Integration tab.
  3. Here, you can configure the product and variant metafields captured in the sync.

Configure Export schedule

By default your entire catalog is resynced from Shopify every eight hours. Please contact support to adjust this schedule.

Synchronization Process

Upon receiving a webhook notification, Layers performs the following steps:

  1. Verification: Confirms the validity of the webhook event.
  2. Data Fetch: Retrieves the latest information on the affected products.
  3. Index Update: Updates the search index to reflect the new or changed data.

Troubleshooting Sync Issues

If you encounter issues with catalog synchronization, consider the following steps:

  • Check Webhook Settings: Ensure that Layers has the correct permissions.
  • Review Product Status: Verify that products are active and published to the correct storefront.

FAQs

Q: How often does catalog sync occur?
A: Synchronization happens in near real-time following the triggering of any subscribed webhook events. Additionally, every eight hours, the entire catalog is bulk exported from Shopify.

Q: Can I manually trigger a catalog sync? A: Yes, you can initiate a manual sync via the Layers dashboard if needed.

Q: Does the catalog sync work with split products or Combined Listings? A: Yes, all published products are synced from Shopify.

Q: How can I hide a product from Layers A: Unpublish it from the Online Store sales channel or add the hide tag.

For more information or if you require assistance, please get in touch with our support team.