Shopify permission requirements
LoyaltyTree.eco needs access to your store to run loyalty points, reward customers, and process tree/eco rewards. Required permissions cover customers, orders,
Shopify permission requirements
Why does the app need access to my store?
LoyaltyTree.eco is a loyalty and rewards app. To run your program we need to:
- Identify and reward your customers (read/write customer data)
- See orders so we can award points, process tree/eco rewards, and add order notes (e.g. certificates)
- Manage products for tree sponsorship and eco products (create, publish, update)
- Fulfill digital items (e.g. tree planting, eco rewards) by marking the right line items as fulfilled
- Store our settings on your shop (via Shopify metafields) so the app and checkout work correctly
We only use the minimum access needed for these features. Some permissions are required to install the app; others are optional and only used if you turn on specific features (e.g. gift cards, store credit, or tier discounts).
Required vs optional
Required permissions are needed to install and run the core app: loyalty points, orders, products, fulfillments, and app configuration (metafields/publications). Without these, the app cannot function.
Optional permissions are not needed to install. We ask for them only when you enable gift cards or store credit as rewards, or tier discounts. You can grant them later from the app (e.g. via “Reconnect” or the permission prompts in admin). If you don’t enable those features, we never use the optional scopes.
How we use your data
We use customer data to link visits and orders to loyalty accounts and show balances/tiers; orders for points and tree/eco rewards and order notes; products to create and manage tree/eco products and (where used) review data; fulfillments to mark reward line items as fulfilled; metafields/publications to save app settings and publish products; and locales/product listings for multilingual support. We don’t sell your data and comply with Shopify app requirements and GDPR-style requests (e.g. data request and redact webhooks).
Detailed permission reference
Every Shopify access scope used by LoyaltyTree.eco, whether required or optional, and the reason we need it.
| Scope | Required / Optional | Purpose |
|---|---|---|
read_customers |
Required | Look up customers by email/ID for loyalty balance, POS loyalty block, referral attribution, and reward redemption. |
write_customers |
Required | Create or update customer records when linking loyalty accounts (e.g. guest merge) and store app-related data where needed. |
read_orders |
Required | Read orders for points calculation, order-paid/created/cancelled webhooks, and to drive tree/eco reward and fulfillment logic. |
write_orders |
Required | Add notes to orders (e.g. tree planting certificates, eco reward details) and support order-related reward flows. |
read_products |
Required | Read product and variant data for wishlists, product reviews, sponsorship/eco product config, and storefront display. |
write_products |
Required | Create and update tree sponsorship and eco products; set product metafields (e.g. average rating for reviews). |
read_publications |
Required | List sales channels (e.g. Online Store, Point of Sale) to know where to publish tree/eco products. |
write_publications |
Required | Publish and unpublish tree sponsorship and eco products to the Online Store and POS. |
read_metaobjects |
Required | Read structured metaobject data when used for app or theme configuration. |
write_metaobjects |
Required | Write app configuration stored as metaobjects where applicable (shop/product settings). |
write_fulfillments |
Required | Mark tree and eco reward line items as fulfilled so they don’t remain unfulfilled in Shopify. |
read_assigned_fulfillment_orders |
Required | Read fulfillment orders assigned to the app so we can fulfill the correct line items. |
write_assigned_fulfillment_orders |
Required | Create fulfillments for assigned fulfillment orders (tree/eco line items). |
read_merchant_managed_fulfillment_orders |
Required | Read merchant-managed fulfillment orders when tree/eco items use that model. |
write_merchant_managed_fulfillment_orders |
Required | Fulfill merchant-managed fulfillment orders for tree/eco rewards. |
read_product_listings |
Required | Access product listings for the storefront (e.g. for correct product data in multilingual stores). |
read_locales |
Required | Read store languages so we can localize the app (e.g. tier names, widget copy) and respect store locale. |
read_gift_cards |
Optional | Read gift card data when using gift cards as a reward type (e.g. to verify or display balance). |
write_gift_cards |
Optional | Create and assign gift cards when customers redeem seeds/points for gift card rewards. |
read_discounts |
Optional | Read existing discounts when managing tier-based automatic discounts (e.g. to update or remove them). |
write_discounts |
Optional | Create and update tier-based automatic discounts (e.g. “Sapling 5% off”) for loyalty tiers. |
read_store_credit_accounts |
Optional | Read store credit accounts when using store credit as a reward type. |
write_store_credit_account_transactions |
Optional | Credit a customer’s store credit account when they redeem seeds/points for store credit. |
Summary: Required scopes power core loyalty, orders, tree/eco products, fulfillments, and app configuration. Optional scopes (gift cards, discounts, store credit) are only used when you enable those reward types or tier discounts in the app.