How to Use Umami Analytics in a Shopify Store

Updated: August 2026

If you run a Shopify store, you already have access to Shopify's own commerce reporting. But understanding how visitors actually move through your storefront, which products generate interest, and where potential customers drop off requires a behavioral analytics layer. Umami Analytics provides exactly that, with a privacy-focused approach that does not rely on cookies or personal data collection by default.

This guide walks through how to connect a Shopify store to Umami, install tracking, define ecommerce events, build conversion funnels, and measure marketing campaigns. If you prefer to run Umami on your own infrastructure rather than using a managed service, our guide on how to self-host Umami Analytics covers the deployment side separately.

Why Use Umami for Shopify Analytics?

A Shopify store can generate a huge amount of behavioral data: product views, searches, cart additions, checkout activity, campaign visits, and purchases. The challenge is turning that activity into useful information without making your analytics setup unnecessarily complicated.

Umami Analytics provides a privacy-focused analytics platform for tracking website activity, custom events, funnels, UTM campaigns, and other insights. Its documentation describes Umami as a privacy-focused platform that does not use cookies or collect personal data by default, while also offering self-hosted and cloud options.

For a Shopify merchant, the most useful approach is to treat Umami as a behavioral analytics layer alongside Shopify's own commerce data.

In other words:

• Shopify remains your source for orders, products, customers, inventory, and store operations.
• Umami helps you understand how visitors move through your storefront and which interactions lead toward conversion.
• Custom events and funnels connect those two perspectives.

That distinction is important. Installing analytics does not automatically turn Umami into a complete replacement for Shopify's administrative and sales reporting.

What Can You Track With Umami?

At a basic level, Umami automatically tracks pageviews when its tracker is installed correctly. The tracker can collect information such as the URL, page title, referrer, browser language, screen dimensions, and other standard analytics properties.

For Shopify, you can go further and define events around important ecommerce actions.

Useful events include:

You can also attach event data. For example, an add-to-cart event could contain a product identifier, product name, quantity, or price.

The key is to track business questions, not every possible click.

Before You Start

You need three things:

1. A Shopify store.
2. An Umami website configured for that store.
3. Access to your Shopify admin's Customer Events area if you plan to use a custom pixel.

Shopify's current pixel system allows merchants to manage customer-event tracking from the Shopify admin. Custom pixels are an advanced feature and require JavaScript knowledge; Shopify also notes that merchants are responsible for compliance, consent, security, troubleshooting, and updates when using custom pixels.

You should also decide whether you are using:

• Umami Cloud, or
• A self-hosted Umami installation.

If you choose self-hosting, the UmamiEngine guide on how to self-host Umami Analytics provides a separate deployment walkthrough.

Add Your Shopify Store to Umami

Start by creating a website in your Umami dashboard for your Shopify domain.

Give it a recognizable name, such as:

My Shopify Store

Then associate the correct store domain with that website.

Once the website has been created, Umami provides the tracking code. Its documentation explains that the tracking code is available from the website settings and normally needs to be installed on the website to begin collecting data.

Keep your website ID available because you may need it when configuring custom tracking.

How to Install Umami on Shopify

There are two broad approaches, but Shopify's Customer Events and pixel system is particularly relevant for modern stores.

Option 1: Use a Shopify Custom Pixel

Shopify provides a Customer Events section where merchants can create and manage custom pixels. The basic workflow is:

1. Open your Shopify admin.
2. Go to Settings.
3. Select Customer events.
4. Create a new custom pixel.
5. Give it a descriptive name, such as Umami Analytics.
6. Add your JavaScript.
7. Save the pixel.
8. Connect the pixel when you are ready to activate it.

Shopify documents this workflow and notes that custom pixels run in a sandbox. That sandbox can impose limitations, so you should test the integration carefully rather than assuming every piece of theme JavaScript will work identically inside the pixel environment.

A simplified Umami tracker configuration conceptually looks like this:

Replace the placeholders with the tracking script URL and website ID generated by your Umami installation.

Important: Do not copy a tracker URL or website ID from another site. Use the values generated for your own Umami website.

Umami also supports configuration such as data-host-url and domain restrictions when required.

Option 2: Add Tracking Through Your Theme

Theme-level implementation can be useful for storefront pageview tracking, particularly when you control the theme and understand Shopify's theme architecture.

However, Shopify has increasingly centralized customer-event tracking around its pixel infrastructure. For a new implementation, it is sensible to evaluate Shopify's current Customer Events system before modifying theme files.

If you already have tracking code installed in your theme, audit it before adding another implementation. Running the same tracker twice can result in duplicate analytics data.

Shopify specifically recommends removing or modifying existing pixel code when adding a custom pixel so that customer events are not counted twice.

Track Product and Ecommerce Events

Pageviews alone rarely tell you enough about an ecommerce store. The real value comes from tracking the specific actions that lead toward a purchase.

Product Views

Pageviews can tell you which product pages receive traffic, but explicit product events can make your reporting easier to interpret.

For example:

umami.track('product-view', {
  product: 'PRODUCT_ID'
});

The exact product information you send should match your analytics requirements and privacy obligations.

Avoid sending unnecessary customer information. Analytics should answer a business question without becoming a warehouse of personal data.

Add to Cart

The add-to-cart action is one of the most valuable events for an ecommerce store.

It tells you that a visitor moved beyond browsing and demonstrated purchase intent.

A programmatic event could look like:

umami.track('add-to-cart', {
  product: 'PRODUCT_ID',
  quantity: 1
});

Umami supports custom event names and event data through its tracker functions.

You can then compare:

Product views → Add to cart → Checkout → Purchase

That sequence is much more useful than simply looking at total traffic.

Checkout and Purchase Events

The purchase event is the most important event in an ecommerce funnel, but it is also the point where careful implementation matters most.

For example:

umami.track('purchase', {
  order_value: 79.99,
  currency: 'USD'
});

Only send information that you have determined is appropriate for your analytics setup.

For stores operating in multiple markets, include the relevant currency rather than assuming every transaction uses the same currency.

Umami also supports server-side events through its API. This can be useful when an important business event is confirmed by a backend or payment system rather than merely occurring in a visitor's browser.

For high-value purchase reporting, a server-side architecture can therefore be worth considering.

Build a Shopify Conversion Funnel

Once your events are working, you can turn them into a conversion funnel.

A basic Shopify funnel might be:

1. Product page viewed
2. Add to cart
3. Checkout started
4. Purchase completed

Umami's funnel functionality supports both page-view steps and event-based steps. You can define each step and set a time window for progression.

This makes it easier to identify questions such as:

• Are visitors reaching product pages but not adding products?
• Are people adding products but abandoning the cart?
• Is checkout the biggest drop-off?
• Which traffic sources produce the strongest funnel progression?

Instead of asking, "How many people visited my store?", you can ask the more valuable question:

"Where are potential customers getting stuck?"

That is where analytics starts influencing actual business decisions.

Use UTM Parameters to Measure Marketing Campaigns

Suppose you promote a product through:

• Email
• Instagram
• Paid advertising
• Influencer partnerships
• Organic social media
• Affiliate campaigns

Use consistent UTM parameters so you can distinguish those traffic sources.

For example:

utm_source=newsletter
utm_medium=email
utm_campaign=summer-sale

Umami includes UTM campaign tracking among its analytics capabilities.

Create a consistent naming convention before launching campaigns. Otherwise, variations such as Facebook, facebook, and fb can fragment your reporting.

Privacy and Consent Considerations

Privacy-friendly analytics does not mean that merchants can ignore applicable privacy laws.

Shopify states that merchants are responsible for compliance when using custom pixels, including customer privacy and consent considerations.

Before deploying Umami, determine:

• Which countries your store serves.
• Which privacy rules apply to your business.
• Whether consent is required for your particular implementation.
• What data your implementation sends.
• Whether third-party services receive any customer information.
• Whether your privacy policy accurately describes your analytics practices.

Umami's privacy-oriented design can simplify the analytics architecture, but it does not eliminate your responsibility to configure the system appropriately. For a deeper look at the compliance angle, see our privacy-focused analytics and GDPR guide.

Common Shopify + Umami Problems

Data is not appearing

First verify that the tracking script is loading.

Umami recommends checking your browser's developer tools and Network tab when troubleshooting missing data. Ad blockers can also prevent tracking requests from being sent.

Events are missing

Check:

• The event name.
• Whether the JavaScript is actually executing.
• Whether the relevant Shopify event is available to your pixel.
• Whether the code is running inside Shopify's pixel sandbox.
• Whether consent settings are preventing execution.

Events are duplicated

Look for multiple installations.

You may have the tracker in both:

• Your Shopify theme, and
• A Shopify custom pixel.

Shopify explicitly warns merchants to account for existing pixel code when adding new custom pixels.

Your reports contain too much data

This is a measurement problem, not an analytics problem.

Do not create an event for every button simply because you can.

Start with the handful of actions that directly support decisions about acquisition, product interest, checkout behavior, and conversion.

Best Practices for Using Umami With Shopify

1. Define your events before writing code

Create an event naming convention first.

For example:

• product-view
• add-to-cart
• begin-checkout
• purchase

This makes reports easier to understand.

2. Keep event names consistent

Don't use add_cart, add-to-cart, and cart-add for the same action.

Pick one convention and document it.

3. Send useful event data

Event data can provide context such as product identifiers, prices, categories, or campaign information. Umami supports structured event data, with documented limits on strings, numbers, arrays, and objects.

4. Don't send unnecessary personal information

Analytics should focus on behavior and business context rather than collecting information simply because it is technically possible.

5. Test before trusting the dashboard

Perform test journeys yourself:

Landing page → Product → Add to cart → Checkout → Purchase

Then verify that each intended event appears in Umami.

6. Use funnels for decisions

A dashboard full of numbers is not necessarily useful.

Funnels, campaign analysis, and event data can help you identify where changes are most likely to improve the customer journey.

7. Keep Shopify as the commerce source of truth

Umami is excellent for behavioral analytics, but Shopify remains the platform managing your actual store operations and transactions.

Use each system for what it does best.

FAQs About Using Umami With Shopify

Can I use Umami Analytics with Shopify?

Yes. You can use Umami to collect storefront analytics and custom events from a Shopify store. Shopify's Customer Events and custom-pixel functionality provides a modern way to implement custom customer-event tracking.

Can Umami track Shopify add-to-cart events?

Yes, provided you implement an appropriate custom event. Umami supports custom events through JavaScript and data attributes, allowing actions such as add-to-cart to be recorded.

Can Umami track purchases?

A purchase can be represented as a custom Umami event, with appropriate event data. For more reliable backend-confirmed tracking, Umami also supports server-side events through its API.

Is Umami a replacement for Shopify Analytics?

Not necessarily. The two tools serve different purposes. Shopify provides native ecommerce and store-management information, while Umami can provide additional behavioral analytics, custom events, funnels, and campaign insights.

Is Umami privacy-friendly?

Umami describes itself as privacy-focused and states that it does not use cookies, fingerprinting, or personal data collection by default. However, your actual compliance position depends on how you configure and use analytics and the laws applicable to your business.

Do I need to modify my Shopify theme?

Not necessarily. Shopify provides a Customer Events system where custom pixels can be created and managed. The best implementation depends on your store, tracking requirements, theme, and the limitations of Shopify's pixel environment.

Why are my Umami events not showing?

Check that the tracker is loading, the event code is executing, the correct website ID is being used, and your browser is not blocking requests. Also check whether Shopify's sandbox or customer-privacy settings affect the event. Umami recommends using browser developer tools to troubleshoot missing tracking data.

Can I self-host Umami for a Shopify store?

Yes. Shopify does not require your analytics platform to be hosted by Shopify. You can use a self-hosted Umami installation and configure your store to send analytics data to it. Umami's official documentation supports self-hosted deployments, while UmamiEngine also provides a dedicated self-hosting guide.

Conclusion

Using Umami with Shopify is less about installing another analytics script and more about creating a measurement system that answers useful ecommerce questions.

Start with the basics: pageviews, product interest, add-to-cart activity, checkout progression, purchases, and campaign sources. Then connect those events into funnels so you can see where visitors move forward—and where they disappear.

Shopify gives you the commerce infrastructure. Umami can add a focused, privacy-oriented view of how people interact with your storefront.

The most effective setup is therefore not the one that tracks the most events. It is the one that tracks the right events, keeps data clean, respects customer privacy, and turns analytics into better decisions about products, campaigns, landing pages, and conversion.

For more practical walkthroughs, explore our other Umami analytics guides.

Get Started with Managed Umami

Ready to try Umami without the DevOps hassle? UmamiEngine provides fully managed Umami analytics with all the depth described above, including funnels, retention, journeys, attribution, and revenue insights. No servers, no databases, no maintenance, just privacy-first analytics in minutes. Get started today and take control of your analytics data.

Get fully managed Umami in minutes