Skip to main content

​
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.
  • app/uninstalled: Fires when the Layers app is uninstalled from your Shopify store.
*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.

​
App Uninstallation and Data Retention

When you uninstall the Layers app from your Shopify store, your data is not immediately deleted. Instead, your store is queued for deletion with a 30-day grace period to allow for accidental uninstallations or changes of mind.

​
What happens during the grace period

  1. Store queued for deletion: Your store and all associated data are marked for deletion but remain intact.
  2. Jobs paused: All background sync jobs are automatically paused to prevent unnecessary processing.
  3. Support notification: A support ticket is automatically created to notify our team.

​
Restoring access after uninstallation

If you uninstalled the app by mistake or changed your mind:
  1. Reinstall the Layers app from the Shopify App Store within the 30-day grace period.
  2. Contact our support team to restore your store and data.
  3. Your previous configuration and data will be preserved and reactivated.

​
Permanent deletion

After 30 days, your store and all associated data will be permanently deleted from our systems. This includes:
  • Product catalog data
  • Search analytics and metrics
  • Configuration settings
  • All historical data
If you have any questions about uninstalling or need assistance, please contact our support team before the 30-day period expires.

​
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: You can unpublish it from the Online Store sales channel, add the hide tag, or configure custom excluded tags in Settings → Search Behavior. By default, products with the hide, algolia-ignore, or layers-ignore tags are excluded from search. For more information or if you require assistance, please get in touch with our support team.