Table of Contents
Introduction
Our Shopify Partner integration helps you understand your app’s performance and make decisions with data-driven confidence. Track key metrics like churn rate, conversion rate, MRR, and more, all in one place.
Our goal is simple: give you clear, actionable insights into your Shopify revenue without the hassle of manual analysis.
This integration is built for Shopify Partners who sell apps on the Shopify platform.
This integration does not connect to individual Shopify stores. It connects to your Shopify Partner account, which contains the billing data for your Shopify app.
Connecting Shopify Partners to Baremetrics
Connecting Shopify to Baremetrics is quick and straightforward. Here's what you'll need.
Within Shopify
Create Your Access Token & Organization ID
Follow the instructions provided at Shopify Partner API Documentation to create your Access Token and Organization ID. These credentials authorize the connection between Shopify and Baremetrics.
Set Required Permissions
We need all permissions ticked for the following reasons:View Financials
Required to view transactions that include subscription sales, one-time charges, fees, and tax charges.Manage Apps
This is necessary because Shopify doesn't have a concept of "plans." Baremetrics estimates the plan name by combining the App name, interval, and price. Without this permission, we cannot retrieve the App name for each transaction.Manage Themes / Manage Jobs
These permissions are required to extract specific fields from transactions related to one-time charges. Without them, API calls may fail when requesting detailed transaction information, which could prevent proper plan naming.
Once permissions are configured, return to Baremetrics to complete the connection.
Within Baremetrics
Go to Settings → Data Connections
Select Shopify Partners
Enter your Access Token and Organization ID
Baremetrics will begin importing your historical data immediately.
Most accounts import within 5–15 minutes, though larger accounts with significant historical data may take longer.
After import, Baremetrics performs several calculations. During this time, some metrics may briefly show 0. This is expected and will resolve once processing completes.
Note: The Shopify GraphQL API is still in beta and only allows read-only operations. Future updates might introduce more granular read/view-only permissions.
The Shopify API is stable but still considered “in development.” We monitor it closely to make sure we can keep it skating along. 👍
Shopify-Specific Considerations
Shopify’s billing system behaves differently from traditional subscription platforms, so Baremetrics applies several adjustments to ensure accurate metrics.
Delayed Revenue Recognition
Baremetrics recognizes revenue only when payments are actually made (AppSubscriptionSale events), not when charges are activated or accepted. This means metrics such as MRR and Net Revenue reflect actual payments rather than pending charges.
Because Shopify rolls app charges into the merchant's Shopify billing cycle, revenue events may appear slightly delayed compared to other integrations.
Read more: Shopify App Charges Explained
Redacted Records
Shopify may mark some older customer records as "REDACTED," which Baremetrics will exclude from metrics.
Fees
In line with our other direct integrations, we do not remove Shopify's fees from MRR, Net Revenue, etc. You can view your fees (if any!) on the Fees Metric.
Churn and Delinquency
Customers are considered Cancelled when:
Baremetrics receives the RelationshipUninstalled event from Shopify or
Based on the subscription interval, the payment has yet to be made on the next expected date. Our logic can't rely on Shopify's "subscription charge canceled" events. Shopify's billing can sometimes extend beyond the standard 30-day cycle. We offer a five-day grace period for Shopify customers to accommodate this inconsistency, making the total delinquency period 35 days. Customers are removed from MRR after delinquency and treated as churn. This setting can be adjusted in Baremetrics under Data Settings.
Trial Tracking
Baremetrics monitors app installs as "trials" and recognizes conversions based on the AppSubscriptionSale event. You can view them within Trial Insights.
Usage Charges and One-Time Sales
UsageCharge charges are not included in MRR. They are included in Other Revenue and Net Revenue. Other Revenue also includes App One-time Sales.
Additional Shopify Data & Customer Enrichment
Because Shopify’s Partner API does not expose certain customer details, Baremetrics provides additional tools to enrich your Shopify customer data.
Email Address Backfilling
Shopify does not provide customer email addresses through the Partner API. Baremetrics allows you to add customer email addresses through the Baremetrics API. Once added, email addresses can be used with:
Baremetrics Messaging
Intercom integrations
HubSpot integrations
Customer segmentation and exports
Additional Shopify Attributes
Baremetrics also imports additional Shopify-specific attributes that can be used for segmentation and analysis.
MyShopify Domain
Each customer includes their associated myshopify_domain, allowing you to identify and segment customers by their Shopify store.
Cancellation Reason
If a merchant provides a cancellation reason when uninstalling your app, Baremetrics stores this value as a customer attribute. This allows you to analyze churn patterns or export cancellation feedback for further analysis.
Shopify Event Handling
Plan Names: Baremetrics generates plan names based on items within Subscription Charge events.
Refunds: Refunds are included through the AppSaleAdjustment event.
One-Time Sales: One-time sales fall under Other Revenue, just like usage charges. These are populated from AppUsageSale and AppOnetimeSale.
Customer Cancellations: Customers are marked as canceled when Baremetrics receives the RelationshipUninstalled event, when a subscription payment fails, or are never received after the expected interval +5 days.
Trial Tracking: Baremetrics automatically tracks trials based on the RelationshipInstalled event, and conversion is recognized at the AppSubscriptionSale event.
Reactivations: Customers are marked as reactivated upon receipt of the RelationshipReactivated event from Shopify.
Customer Cancellations: Baremetrics marks customers as canceled upon receiving the RelationshipUninstalled event, after a failed subscription payment, or if no payment is received by the expected interval plus 5 days.
Disconnecting Shopify from Baremetrics
To disconnect your Shopify Partner account:
Go to Settings → Data Connections
Locate the Shopify Partners integration
Click Disconnect
FAQ
Why don’t customer email addresses appear in Baremetrics?
Shopify’s Partner API does not expose customer email addresses. If you want to use emails for messaging or integrations, you can backfill email addresses using the Baremetrics API.
Why does revenue sometimes appear delayed?
Shopify bills app charges through the merchant’s Shopify subscription invoice, which means payments may occur later than the initial charge activation.
Baremetrics records revenue when the payment is actually made, which can cause a small delay compared to activation events.
Why are some customers marked as REDACTED?
Shopify occasionally redacts older merchant data for privacy reasons. These records appear as REDACTED in the Shopify API.
Why aren’t coupons reflected in MRR?
The Shopify Partner API does not currently expose coupon discount data. Because of this limitation, coupon discounts cannot be reflected in MRR calculations at this time.
Additional Resources
If you'd like to learn more about Shopify billing and Baremetrics metrics, the following resources may help.