How to set up your first project on Mixpanel

beginner 8 min read Updated 2026-03-18
Quick Answer

Setting up your first Mixpanel project involves creating an account, configuring your project settings, and implementing the tracking code. The process typically takes 10-15 minutes and requires basic technical knowledge.

Prerequisites

  • A Mixpanel account
  • Basic understanding of web analytics
  • Access to your website or application code
  • Admin permissions for your organization

Step-by-Step Instructions

1

Create your Mixpanel account and organization

Visit mixpanel.com and click Get Started Free. Fill in your email, password, and company information. After email verification, you'll be prompted to create your first organization. Enter your Organization Name and select your industry from the dropdown menu.
Use a company email address for better team collaboration features later.
2

Set up your first project

On the welcome screen, click Create Project. Enter your Project Name (e.g., "My Website" or "Mobile App"). Select your Data Residency (US or EU based on your compliance needs). Choose your Project Timezone to ensure accurate reporting. Click Create Project to proceed.
Project timezone cannot be changed later, so choose carefully based on your primary user base.
3

Choose your implementation method

Mixpanel will present implementation options. Select JavaScript for web applications, Mobile SDK for iOS/Android apps, or Server-side for backend tracking. For beginners, choose JavaScript for web tracking. Click Continue to get your unique project token and code snippet.
You can always add multiple implementation methods later for cross-platform tracking.
4

Install the Mixpanel tracking code

Copy the provided JavaScript snippet that includes your unique project token. Paste this code in the <head> section of every page you want to track. The code looks like:
<script type="text/javascript">
(function(c,a){if(!a.__SV){var b,d,h,e;window.mixpanel=a;a._i=[];a.init=function...
</script>
Save and deploy your changes.
Use Google Tag Manager for easier implementation if you're not comfortable editing code directly.
5

Verify tracking installation

Return to Mixpanel and click I've Installed the Code. Navigate to a page with the tracking code and perform some actions (clicks, page views). In Mixpanel, go to Live View from the left sidebar. You should see your events appearing in real-time within a few minutes.
Open your browser's developer console to check for any JavaScript errors that might prevent tracking.
6

Configure your first events

Go to Events in the left sidebar to see automatically tracked events like page views. To track custom events, add code like: mixpanel.track('Button Clicked', {'button_name': 'Sign Up'}); Set up key events such as sign-ups, purchases, or feature usage based on your business goals.
Start with 5-10 key events that matter most to your business before adding more detailed tracking.
7

Set up user profiles and properties

Navigate to Users to configure user tracking. Implement user identification with mixpanel.identify('user_id'); and set user properties using mixpanel.people.set({'$email': 'user@example.com', '$name': 'John Doe'}); This enables cohort analysis and user journey tracking.
Always call mixpanel.identify() before setting user properties to ensure data is attributed correctly.
8

Create your first report

Go to Insights to create your first analysis. Click + New Report, select an event from the dropdown, and choose your date range. Add filters or breakdowns by clicking + Filter or Breakdown. Click Save to add the report to your dashboard for ongoing monitoring.
Start with simple reports like daily active users or page views before creating complex funnels or retention analyses.

Common Issues & Troubleshooting

Events not appearing in Live View

Check your browser's developer console for JavaScript errors. Ensure the tracking code is placed in the <head> section and your project token is correct. Try disabling ad blockers which may block analytics scripts.

Duplicate events being tracked

Verify the Mixpanel code is only included once per page. Check for multiple implementations (direct code + Google Tag Manager). Use mixpanel.track() calls sparingly and avoid placing them in loops.

User properties not updating

Ensure you're calling mixpanel.identify() before mixpanel.people.set(). Check that your project has People Analytics enabled in project settings. Verify the user ID is consistent across sessions.

Data appears in wrong timezone

Project timezone is set during initial setup and cannot be changed. Create a new project with the correct timezone if needed. For temporary fixes, adjust report date ranges manually to account for timezone differences.

Prices mentioned in this guide are pulled from current plan data and may change. Always verify on the official Mixpanel website before purchasing.