Permissions & Syncs
Permissions and synchronization to be enabled in Shopify
Shopify Permissions
The integration operates under the principle of least privilege and requests only the permissions required to deliver core functionality:
| Permission Category | Required Scopes | Purpose & Functionality |
|---|---|---|
| Products | read_products, write_products, read_inventory | Syncs product, variant, pricing, and inventory data so recommendations and search reflect what’s actually sellable. |
| Content | read_content, write_content | Used to read and configure storefront content that powers merchandising logic and on-site experiences. |
| Files | read_files, write_files | Required to manage assets used by storefront components and visual experiences. |
| Online Store / Themes | read_themes, write_themes, write_script_tags | Allows Malachyte to install theme extensions, render recommendation and search blocks, and enable storefront tracking. |
| App Development | read_apps, write_apps | Needed to install, configure, and maintain the Malachyte app and its integrations. |
| Store Settings / Analytics | read_analytics | Used to understand store configuration and measure the performance of on-site experiences. |
| Pixels / Customer Events | read_customer_events, write_pixels, write_custom_pixels | Enables privacy-conscious tracking of shopper interactions for attribution, analytics, and real-time personalization. |
| Locations | read_locations | Required to determine inventory availability and fulfillment eligibility by location. |
| App Permissions | read_app_installations, write_app_installations | Allows proper installation and management of required apps and sales channels. |
| Customers | read_customers | Used only to read shopper identifiers for analytics and personalization; no shopper data is modified. |
| Orders | read_orders | Used to measure performance and attribution; orders are never modified. |
Catalog Synchronization
Malachyte maintains an up-to-date copy of the product catalog to support recommendations and search.
Key Fields Synced
Product Data
Product ID, Title, Handle, Status, Tags, Description, Vendor, Product Type, Created Date, Updated Date, Published Date, Options, Metafields, Images, Publications, Collections
Variant Data
Variant ID, Title, Price, Compare-at Price, SKU, Barcode, Inventory Quantity, Created Date, Updated Date
Inventory & Availability
- Variant Inventory Quantity
- Inventory Availability by Location
- Location Details:
Location ID,Location Name - Fulfillment:
Online Fulfillment Status
Sync Architecture
| Sync Type | Frequency | Description |
|---|---|---|
| Daily Sync | Every day at 6 AM | Full product catalog ingestion to ensure data integrity and catch any missed edge cases. Launching a product drop or new collection the same day? Tell the Malachyte contact ahead of time and they can trigger an extra pull so it shows right away. |
| Real-Time Sync | Instant | Handled via Shopify Webhooks for create, update, and delete events to maintain live accuracy. |
Pixel Tracking
Malachyte leverages Shopify’s Theme App Extension to inject a lightweight tracking script into the client's storefront. This method ensures high performance without modifying core theme files.
Events Tracked
- Page views – General site navigation
- Product views – Deep dives into specific SKUs
- Add to cart – High-intent shopping actions
- Search – Search queries entered on the storefront
- Checkout initiated – Start of the conversion funnel
- Purchase completed – Final transaction and attribution
Important
Privacy & Compliance: All event data is pseudonymized and adheres to enterprise privacy standards. Custom shopper identifiers can be supported via specific integration settings.