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 us 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 customer 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 customer identifiers for analytics and personalization; no customer 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 24 Hours | Full product catalog ingestion to ensure data integrity and catch any missed edge cases. |
| 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 your 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
- 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 user identifiers can be supported via specific integration settings.