> For the complete documentation index, see [llms.txt](https://docs.roadmap.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roadmap.so/getting-started/shopify-permissions.md).

# Shopify permissions

When Roadmap is installed on your Shopify store, it requests certain permissions to function properly. These permissions allow Roadmap to connect with your store data, display widgets on your storefront, and keep everything in sync.

This article explains which permissions are required and why we need them, so you can feel confident about how Roadmap works with your store.

{% stepper %}
{% step %}

#### Products

**Why?** Roadmap needs access to your products so it can:

* Create bundles and discounts (including GWP promotions).
* Display reviews on product pages.
* Apply loyalty or subscription rules to specific products or collections.
  {% endstep %}

{% step %}

#### Customers

**Why?** Roadmap uses customer data to:

* Track loyalty points, referrals, and tier progression.
* Segment customers with tags.
* Sync loyalty, review, and subscription data with Klaviyo.
  {% endstep %}

{% step %}

#### Orders

**Why?** Order access lets Roadmap:

* Award loyalty points for purchases.
* Track subscription renewals and billing events.
* Measure performance in analytics (AOV, conversion, churn).
  {% endstep %}

{% step %}

#### Themes & Storefront Content

**Why?** Roadmap needs limited theme access to:

* Inject lightweight code for widgets (loyalty, reviews, bundles, etc.).
* Provide app blocks that you can place via the Shopify theme editor.
* Ensure widgets display correctly in cart, checkout, and POS.
  {% endstep %}

{% step %}

#### Checkout (where supported)

**Why?** Roadmap integrates with Shopify checkout to:

* Apply loyalty redemptions and discounts.
* Display bundles and GWPs at checkout.
* Allow subscription checkout flows.
  {% endstep %}

{% step %}

#### Analytics & Reports

**Why?** Analytics access allows Roadmap to:

* Combine data from loyalty, reviews, subscriptions, and bundles into unified dashboards.
* Provide insights on performance and customer retention.
  {% endstep %}
  {% endstepper %}

### Important Notes

* Roadmap only requests the permissions necessary for its features.
* All permissions are handled through Shopify’s secure app framework.
* You can review and manage permissions at any time in your **Shopify admin → Settings → Apps and sales channels**.

### Summary

Roadmap requires access to **products, customers, orders, themes, checkout, and analytics** to power its features. These permissions ensure Roadmap can apply loyalty points, create bundles, run subscriptions, display reviews, and generate reports — all while staying fully integrated with Shopify’s secure platform.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.roadmap.so/getting-started/shopify-permissions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.