Documentation
Everything Mrkr does, and how to make it do it.
Install it in a minute, then go as deep as you want. Press / anywhere to search.
mrkr.app/demo
Every screenshot in these docs is captured from the live demo, so you can click through anything you see here.
Install MrkrOne script tag, then your first pageview.Capture eventsWhat is captured for free, and how to send your own.Build a funnelTurn a sequence of events into a conversion rate.Understand billingPageviews are the billing unit. Everything else is free.
Overview
What Mrkr is and how the pieces fit together.
Get started
Install the script tag and confirm data is flowing.
Tracking
How events get from a visitor's browser to a number on your dashboard.
- How tracking worksWhat happens between a pageview firing in the browser and a number changing on your dashboard, and why Mrkr's queries stay fast at scale.
- Script tag referenceEvery data-* attribute the tracker reads, their defaults, and which settings live in the dashboard instead of the snippet.
- What Mrkr records automaticallyEverything the script collects with no code from you, and the one thing it deliberately does not: what a visitor clicks.
- Custom eventsTrack your own events with mrkr.track() or the declarative data-mrkr-event attribute, with the exact property limits, and why none of it is billed.
- Revenue trackingRecord purchases with mrkr.revenue(), what unit the amount is in, how zero amounts behave, and where the numbers show up on your dashboard.
- Scroll depth and engagementScroll-depth thresholds, engaged time, the minimum-scrollable-height rule, and why short pages intentionally report nothing.
- Session replayTurn on session replay, control sampling and input masking, and understand where recordings are stored, for how long, and what is never captured.
- Bots, spam, and excluded trafficHow bot filtering works, AI crawler classification, referrer spam, excluded paths, and what to do about your own traffic.
- Single-page appsWhat tracks automatically in a client-side-routed app, what doesn't, and the documented limitation around Web Vitals on route changes.
Analyze
Every page in the dashboard, what it counts, and how the numbers are defined.
- The dashboard, page by pageA map of the whole dashboard: the KPI row, the main chart, the range picker, and what each breakdown page counts, in one place.
- Date ranges and comparisonsEvery range preset, what counts as "today" in your timezone, how period comparison works, and exactly how fresh the numbers on screen are.
- Filters and segmentsEvery filter dimension, how filters combine, filtering by cohort, and how a filtered view carries across pages and links.
- EventsThe live feed, the event catalog, conversions and starring, the event detail drawer, and how outbound clicks and downloads are collapsed.
- FunnelsBuilding a funnel: step matching, conversion windows, order modes and how they differ from other tools, exclusions, breakdowns, and drop-off.
- CohortsWhat a cohort is, every condition type, all/any matching, how membership is materialized and refreshed, the member cap, and using a cohort as a filter.
- Engagement: stickiness and scroll depthThe exact stickiness definition, and an honest read of the scroll-depth denominator, including why short pages show no data at all.
- RealtimeThe realtime view, the five-minute live-visitor window behind every number on it, what is on screen, and how often each surface refreshes.
- Visitors and the visitor drawerThe visitor list, how identity works in cookieless vs. cookie mode, and the drawer: journey timeline, scroll depth, tracked events, and replay links.
- Sharing: public links, live maps, and embedsPublic dashboard links, live visitor maps, the counter embed, and the generated privacy page, plus exactly what a recipient can and cannot see.
Configure
Sites, teams, tracking modes, and data lifecycle.
- SitesAdd a site, switch between sites, change its tracking mode, replay and excluded-path settings, and understand what deleting one removes.
- Team and workspacesWorkspaces as the billing root, inviting teammates, per-site access, the three roles and what each can do, and how to hand off ownership.
- Cookieless and cookie modeThe two ways Mrkr identifies repeat visitors, why cookieless cannot follow anyone across days, and what changes in your numbers when you switch.
- Excluding trafficKeep your own visits, staging routes, and bots out of your analytics with path patterns, and keep secrets in query strings out of storage.
- Managed proxyServe the tracker and its ingest endpoint from a neutral subdomain of your own domain, so adblockers have no third-party host to match.
- Data and exportsWhere your analytics data lives, how long each plan keeps it, what the nightly cleanup actually prunes, and how to get your data out.
Billing
How the plan, the usage meter, and your invoice work, exactly.
- How billing worksPageviews are the billing unit and nothing else counts. The plan, the monthly allowance, metered overage, and how to read the usage meter.
- What counts toward your quotaPageviews are the only billable unit. The exhaustive list of what is counted and what is free, verified against the ingest code.
- PlansPrice, included pageviews, site limit, and retention for Starter, Pro, and Business, the trial, and what happens when you exceed your plan.
- Managing your subscriptionUpgrading, downgrading, payment methods, invoices, failed payments, and exactly what happens to your data and limits after you cancel.
- Billing FAQDirect answers to the billing questions that come up most: what counts, what is free, bots, excluded paths, overage, and per-workspace usage.
Best practices
How to get analytics you can act on, not just numbers you can look at.
- Event namingA naming convention for custom events that survives contact with a real team, and why it matters more here than in most tools.
- Planning a tracking planHow to decide what to track before you write any code, with worked examples for a SaaS signup flow and an ecommerce checkout.
- Designing funnels that tell you somethingStep count, conversion windows, order modes, and when a breakdown beats a second funnel: how the funnel engine actually behaves.
- Getting numbers you can defendExcluding internal traffic, how bot filtering works, avoiding double-counting, why cookieless visitor counts run high, and comparing against other tools.
- Pre-launch checklistEverything to confirm before you tell anyone the dashboard is live: install, conversions, funnel, internal traffic, team, retention, usage.
Reference
Exact definitions: every metric, every API method, every payload field.
- Metrics glossaryThe exact definition of every metric shown in the product, matched to the query that computes it, including where the numbers legitimately disagree.
- JavaScript APIEvery method on window.mrkr, the declarative data-attribute alternative, and what happens if you call it before the tracker has loaded.
- HTTP ingest APIThe tracker's ingest endpoint, its payload contract, and a plain statement of what it is not: a supported server-side tracking API.
- TroubleshootingSymptom-driven fixes: no data, numbers too low or too high, missing events, replay not recording, empty funnels, empty realtime.
Cannot find what you need?
Ask us directly. We answer questions about your own setup, not just the documented paths.
Get in touch