Track app earnings and history

Once merchants install your app, Shopify records which stores have your app installed, what you earn from their charges, and an app history of every charge, credit, and install event. You can export this data, follow how earnings become payouts, and look up what each app history event means.

For install counts, performance metrics, and logs, refer to Monitor app performance.

Anchor to Export app dataExport app data

For a more detailed list of the merchants who have installed your app, or a record of your earnings and app history, you can export the data as a CSV file:

1. From your Partner Dashboard, click App distribution.
2. Click the name of the app that you want to export data for.
3. Click Export and select what to export:
   • Current merchants
   • Earnings
   • History
4. Check your email inbox for a message indicating that the export was completed.
5. Open the email and click Download CSV file to save the CSV.

These exports cover one app across all of your payouts. To export the earnings, Shopify fees invoice, or payout statement for a single payout, refer to Export payout data.

The current merchants export provides additional details, such as the type of plan merchants are on, when the app was installed, and whether it was organic or attributed to a paid ad campaign.

Anchor to Why install counts differ between the dashboardsWhy install counts differ between the dashboards

The Dev Dashboard and the Partner Dashboard count installs differently, so the two sets of numbers can differ.

The Installs card on an app's Overview in the Dev Dashboard counts every store whose installation is still on record, which is installs minus uninstalls.

The Partner Dashboard's Merchants with your app metric counts only active stores: those on a paid or trial plan, staff stores, and development stores, but not stores that are canceled or frozen.

The two match when every store with your app is active. The Dev Dashboard number is the larger one when any of them isn't.

For definitions of Installs, Install events, and Uninstall events, refer to Monitor app performance.

Anchor to EarningsEarnings

The earnings amount refers to how much an app developer has been paid. It includes both paid out amounts and pending payments, and it reflects the deduction of Shopify's revenue share and any application credits. Your share of the revenue is defined in the Shopify Partner revenue share agreement.

Anchor to From a charge to a payoutFrom a charge to a payout

An app charge becomes an earning once Shopify collects it from the merchant. Earnings accumulate into your next payout, which is paid to the payout method that's set up once for the whole organization. Each stage has its own surface:

• Individual app charges, and the stores they came from, are on the app charge overview page in the Partner Dashboard. Refer to View charges and earnings.
• The payout your earnings are going into, and the payouts already paid, are in Payouts in your organization settings.
• A summary of your next and previous payout is on the Payouts card on Dev Dashboard Home. Refer to Monitor your organization.

Setting up a payout method, payout thresholds and schedules, and payout holds are organization-level concerns rather than app-level ones. You set up your payout method in Payouts in your organization settings. Refer to Getting paid in the Shopify Help Center.

Anchor to Payment schedulePayment schedule

Payments occur after a merchant has paid their Shopify invoice. The payment schedule depends on the type of charges made by the app:

• For a RecurringApplicationCharge, it can take up to 37 days from the time a merchant agrees to the charge to the time that the charge appears as an earning.
• For an ApplicationCharge, merchants are invoiced immediately and the charge appears as an earning within 7 days.

If your app uses Shopify App Pricing, Shopify creates the subscription and usage charges for you, and the same schedules apply to those charges.

Anchor to App historyApp history

Important user interactions with your app are tracked as events, which you can view in the app history log in your Partner Dashboard. The app history log displays all the tracked events for your app, with the most recent events appearing at the top. The following events are available:

• Application charge events
• Application credit events
• Application install events
• Recurring charge events
• Usage charge events

Anchor to View app historyView app history

1. From your Partner Dashboard, click App distribution.
2. Click the name of your app.
3. Click App history.

Anchor to View one store's app historyView one store's app history

To see one store's history instead of the whole app's, open your app in the Dev Dashboard. On its Overview, in the Installs card, click the install count to open Current installs, and then click the store. The store's app history page lists the same events in its Activity card. Its summary shows the store's Current subscription, which is your app's plan on that store, and Install date and, depending on your permissions, App earnings.

App earnings is a gross figure for one app on one store: the lifetime earnings from your app on that store, including credits and refunds. It isn't the net earnings amount described on this page, which deducts Shopify's revenue share, and it isn't a payout.

The Activity card names some events differently from the tables on this page:

• Application charge events are One-time charge events, such as One-time charge accepted.
• Recurring charge events are Subscription charge events, such as Subscription charge activated.
• Installed and Uninstalled are App installed and App uninstalled.

The card also records Store closed and Store reopened when the store closes or reopens.

Anchor to Application charge eventsApplication charge events

The following table includes definitions of application charge events:

Anchor to Application credit eventsApplication credit events

The following table includes definitions of application credit events:

Anchor to Application install eventsApplication install events

The following table includes definitions of application install events:

Anchor to Recurring charge eventsRecurring charge events

The following table includes definitions of recurring charge events:

Anchor to Usage charge eventsUsage charge events

The following table includes definitions of usage charge events: