Permissions - DigiFist Documentation

Galantis requests a defined set of Shopify permissions during installation. Each permission unlocks a specific category of data access or action capability. No permissions are requested speculatively — every permission maps directly to a platform feature. If a permission is not granted, the feature that depends on it will not function.

What this covers

All required Shopify permissions
What each permission enables in Galantis
What breaks if a permission is missing or revoked
How to verify permission status

Required permissions

Customers
Orders
Products & Collections
Checkouts
Script Tags

read_customers — Allows Galantis to read customer records from Shopify. Enables:

Initial customer import at installation — populates the Galantis contact database with your existing customers
Processing of customers/create, customers/update, and customers/delete webhooks — keeps customer profiles current
Reading customer phone numbers, names, emails, tags, and locale for contact profiles
Audience targeting — lists and segments draw from synced customer data

write_customers — Allows Galantis to write to customer records in Shopify.Enables:

Updating marketing consent state on the Shopify customer record when changes originate in Galantis

If missing: Customer profiles will not sync. Campaigns and automations targeting customers will have stale or empty audience data. Consent state will not update.

read_orders — Allows Galantis to read order records from Shopify.Enables:

Processing of orders/create, orders/cancelled, and orders/updated webhooks — powers ORDER_PLACED, ORDER_CANCELLED, and ORDER_SHIPPED automation triggers
Order data availability in automation condition evaluation (ORDER_VALUE, ITEM_COUNT_IN_ORDER, ORDER_RECENCY)
Order history display in the Inbox customer context panel
Segment rules based on purchase history (total spent, order count, days since last order, purchased collection)
Template variable mapping for order.order_number, order.total_price, order.product_name

read_fulfillments — Allows Galantis to read fulfillment data from Shopify.Enables:

Detecting when an order has been fulfilled and shipped
Powering the ORDER_SHIPPED automation trigger via the orders/updated webhook with fulfillment data

If missing: Order-based automation triggers (ORDER_PLACED, ORDER_CANCELLED, ORDER_SHIPPED) will not fire. Segment rules based on purchase history will not evaluate correctly. Order context will not appear in the Inbox.

read_products — Allows Galantis to read product and collection records from Shopify.Enables:

Processing of products/create, products/update, and products/delete webhooks — keeps the Galantis product catalog current
Processing of collections/create, collections/update, and collections/delete webhooks — keeps collection data current
Catalog module functionality — product data synced into Galantis and available for Meta push
Back-in-Stock module — inventory quantity monitoring per variant
Segment rules based on purchased collection or purchased brand
Automation condition evaluation using PRODUCT_IN_ORDER_HAS_TAG

If missing: The Catalog module will not function. Back-in-Stock inventory monitoring will not work. Product-based segment rules will not evaluate. Catalog message formats (SPM, MPM, Whole Catalog) will be unavailable.

read_checkouts — Allows Galantis to read checkout records from Shopify via the Admin GraphQL API.Enables:

The abandoned checkout polling mechanism — Galantis queries the Shopify Admin API every 10 minutes for incomplete checkouts
The ABANDONED_CHECKOUT automation trigger

If missing: The ABANDONED_CHECKOUT trigger will not fire. Abandoned checkout recovery automations will be inactive even if configured and activated.

Shopify does not provide a real-time webhook for abandoned checkouts. The read_checkouts permission enables polling rather than event-driven detection. See Abandoned Checkout for how the polling mechanism works.

read_script_tags — Allows Galantis to read the script tags currently installed on your Shopify store.write_script_tags — Allows Galantis to write, update, and delete script tags on your Shopify store.Enables:

Injecting the Inbox storefront chat widget into your theme
Injecting the Back-in-Stock subscription widget into your theme
Updating widget scripts when configuration changes are saved in the Galantis dashboard

If missing: Neither the Inbox widget nor the Back-in-Stock widget will appear on your storefront. Widget configuration saved in Galantis will have no effect on the live store.

If write_script_tags is revoked after installation, existing injected scripts may continue to load from cache temporarily, but any configuration changes made in Galantis will not deploy to the storefront. Re-granting the permission and saving widget settings will re-establish the injection.

Permission summary

Permission	Required for	Blocks if missing
`read_customers`	Customer sync, audience targeting	Contact profiles, campaigns, automations
`write_customers`	Consent state writeback	Consent sync
`read_orders`	Order triggers, segments, Inbox context	Order automations, purchase-based segments
`read_fulfillments`	ORDER_SHIPPED trigger	Shipping automation trigger
`read_products`	Catalog, Back-in-Stock, product conditions	Catalog module, BIS module, product segments
`read_checkouts`	Abandoned checkout trigger	ABANDONED_CHECKOUT automation
`read_script_tags`	Widget management	Widget deployment
`write_script_tags`	Widget injection	Inbox widget, Back-in-Stock widget

Verifying permissions

Permissions are granted during app installation and displayed in Shopify Admin → Settings → Apps and sales channels → Galantis → Permissions. If a feature is not working as expected and data issues are suspected, verifying the permission set is a quick first diagnostic step — particularly for script tag permissions, which can be affected by certain Shopify plan changes or reinstallation flows.

Getting Started — Shopify Installation — How permissions are granted during installation
Webhooks — How individual webhooks depend on these permissions
Support — Widget Not Displaying — Troubleshooting script tag permission issues

​What this covers

​Required permissions

​Permission summary

​Verifying permissions

​Related guides

What this covers

Required permissions

Permission summary

Verifying permissions

Related guides