Docs Platform Activity

Activity

Your app’s installation activity is the foundation of everything else - revenue, growth, customer satisfaction - it all starts here. The Activity report brings your Shopify Partner installation data into Mantle, enriching it with segmentation capabilities and putting it alongside all your other metrics where it belongs.

What makes this report different

While you can find basic installation numbers in your Partner Dashboard, Mantle’s Activity report brings everything together in one view and adds a powerful twist: segments. Want to know how Plus stores are behaving differently from your other customers? Or how that new marketing campaign affected installations in a specific region? Now you can.

Report components

Installation activity overview

Installation overview

Right at the top, you’ll see five key metrics that tell the story of your app’s movement:

  • Installed: Brand new customers giving your app a try. These are merchants who’ve never installed your app before - fresh faces in your user base.
  • Uninstalled: Customers who’ve removed your app. Don’t worry too much about individual uninstalls, but watch for patterns that might signal larger issues.
  • Deactivated: Shops that have been frozen by Shopify or closed by the merchant. This one’s usually out of your control, but it’s important to understand how it affects your numbers.
  • Reinstalled: The comeback stories - customers who uninstalled but decided to give your app another shot. These are particularly interesting because they often signal improvements in your product or marketing.
  • Reactivated: Shops that were previously frozen but are now back in business. Keep an eye on these - they might need a little extra attention to get back up to speed.

Each metric shows a percentage change from the previous period, helping you quickly spot trends in any direction.

Interactive visualization

Interactive visualization

The main chart brings these metrics to life in two powerful ways:

  • Stacked View: When no metric is selected, you’ll see all activities stacked together, showing how different types of movement contribute to your overall activity levels.
  • Focused Analysis: Click any metric to isolate it, making it easier to spot patterns or investigate specific trends. Perfect for when you need to dig into why installations spiked last Tuesday or understand your typical uninstall patterns.

Active users tracking

Active users

Below the activity chart, you’ll find your active user count. This isn’t just installed users - it’s specifically shops that have your app installed AND are actively running on Shopify. Why the distinction? Because an installed but frozen shop isn’t really a potential customer until they reactivate.

Understanding your numbers

How “active users” is calculated

Active users represents shops that have your app installed AND are currently able to use it. This means:

  • Shops with your app installed
  • Minus any shops that are frozen or closed
  • Gives you the true count of shops you can engage with

Frozen or closed shops can’t use your app until they reactivate, so we don’t count them as “active” even though your app is technically still installed.

Understanding different event types

Installed vs Reinstalled

  • Installed: Brand new customers who’ve never used your app before
  • Reinstalled: Previous customers giving your app another try after uninstalling

Deactivated vs Uninstalled

  • Uninstalled: Merchant actively chose to remove your app
  • Deactivated: Shop was frozen/closed (merchant didn’t choose this)

Why this distinction matters: Deactivated shops often reactivate later and become customers again, while uninstalls typically indicate a deliberate decision to stop using your app.

Movement patterns

Different types of movement tell different stories:

  • High reinstall rates might mean your app has strong product-market fit but needs work on initial onboarding
  • Increasing uninstalls could signal user experience issues or new competition
  • Lots of reactivations might mean it’s time to build a “welcome back” campaign

Making the most of this report

Strategic planning

Use activity data to inform key decisions:

  • Track installation trends to measure marketing effectiveness
  • Monitor uninstall patterns to spot potential product issues early
  • Watch reactivation rates to identify re-engagement opportunities
  • Use segmentation to understand how different types of customers behave

Pro tips

Get more value from your activity tracking:

  1. Regular Check-ins
    • Make this part of your weekly routine
    • Look for patterns in day-of-week or time-of-month activity
    • Compare current trends against historical patterns
  2. Smart Segmentation
    • Break down activity by store plan to understand your market
    • Track geographical segments to inform regional strategies
    • Monitor how different customer types respond to app updates
  3. Trend Analysis
    • Use the period comparison to spot seasonal patterns
    • Watch for unexpected changes that might need investigation
    • Look for relationships between different types of activity

Remember: Every merchant who has your app installed, even if they’re not subscribed, is closer to becoming a paying customer than those who’ve never tried it. Understanding your activity patterns helps you focus your efforts where they’ll have the biggest impact.

Frequently Asked Questions

Understanding the Metrics

Why is my "Active Users" count different from my install count?

Active Users only counts shops that can actually use your app right now. If a shop gets frozen or closed, they're removed from active users even though your app is still technically installed.

What's the difference between "Deactivated" and "Uninstalled"?

Deactivated: Shop was frozen or closed (not the merchant's choice)
Uninstalled: The merchant actively chose to remove your app

Deactivated shops often reactivate later, while uninstalls typically indicate the merchant wanted to stop using your app.

What counts as a "Reactivated" event?

When a previously frozen/closed shop reopens and your app becomes active again. The merchant never actually removed your app - it was just temporarily unavailable.

Using the Report

Can I filter activity by customer type?

Yes! Use customer segments to break down activity by Shopify plan (Basic, Plus, etc.), geography, or other attributes.

What does "Include reactivated + deactivated events" mean?

This lets you choose whether to include shop closures/reopenings in your activity:
Include: Shows all activity including when shops get frozen/unfrozen
Exclude: Only shows installs, uninstalls, and reinstalls (merchant actions only)

Why might I want to exclude reactivated/deactivated events?

If you want to focus on what merchants are actually doing rather than Shopify's automated shop management.

Why does the Shopify Partner Dashboard show a different number?

Shopify shows all installs as one number, meaning they combine installs, reinstalls, and reactivations into a single count. Mantle breaks these down into separate categories so you can see the different types of activity and understand what's really happening with your app.

Need help making sense of your activity patterns? Our team is here to help you get the most out of this report!