The page view tracking feature is the core of Medama that is enabled by default when you add the tracking code to your website. This feature allows you to track when a user loads a new page on your website and includes additional metadata about the visitor, such as the page URL, referrer URL, browser language, and more.
We recommend checking out our Demo Dashboard to fully understand what data is collected and how it is displayed.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Medama Analytics","colors":{"primary":"#17cd8c","light":"#07C983","dark":"#108c6e"},"favicon":"/favicon-512x512.png","logo":{"light":"https://mintcdn.com/medama/YpyW_DRIsi4t2IIc/logo/banner-light.svg?fit=max\u0026auto=format\u0026n=YpyW_DRIsi4t2IIc\u0026q=85\u0026s=27047cdf1925c2658f0c2352de238d39","dark":"https://mintcdn.com/medama/YpyW_DRIsi4t2IIc/logo/banner-dark.svg?fit=max\u0026auto=format\u0026n=YpyW_DRIsi4t2IIc\u0026q=85\u0026s=b03c8cca299751a61be16b7ed195416e"},"api":{"playground":{"display":"simple"}},"navbar":{"primary":{"type":"github","href":"https://github.com/medama-io/medama"}},"seo":{"metatags":{"og:description":"Medama Analytics is an open-source project dedicated to providing self-hostable, cookie-free website analytics. With a lightweight tracker of less than 1KB, it aims to offer useful analytics while prioritising user privacy.","og:url":"https://medama.io","og:logo":"/logo/banner-dark.svg","og:image":"/img/demo.png","twitter:image":"/img/demo.png","twitter:site":"@medama_io","twitter:creator":"@ayuhitoo"},"indexing":"all"},"footer":{"socials":{"github":"https://github.com/medama-io"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"medama","hasAudioNarration":false,"actualSubdomain":"medama","customDomains":[],"gitSource":{"type":"github","owner":"medama-io","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21c9223220368938b02111","collectionId":"4aa781e1-915a-49ee-a456-f8888ad14b25","schemaVersion":"v2"},"entitlements":{},"buildId":"6ae91d07b06fa73e673b5531:success","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"API Reference","count":28},{"language":"default","tag":"Documentation","count":19},{"language":"default","tag":"Stats","count":13},{"language":"default","tag":"Deployment","count":6},{"language":"default","tag":"Website","count":5},{"language":"default","tag":"Guides","count":5},{"language":"default","tag":"Methodology","count":5},{"language":"default","tag":"User","count":4},{"language":"default","tag":"Features","count":4},{"language":"default","tag":"Data Collection","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"features/page-views","slug":"/features/page-views","pageMetadata":{"title":"Page Views","description":null,"href":"/features/page-views"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,..._provideComponents(),...props.components},{Info,OptimizedImage}=_components;if(!Info)_missingMdxReference(`Info`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`The page view tracking feature is the core of Medama that is enabled by default when you add the tracking code to your website. This feature allows you to track when a user loads a new page on your website and includes additional metadata about the visitor, such as the page URL, referrer URL, browser language, and more.`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/medama/YpyW_DRIsi4t2IIc/img/demo.png?fit=max\u0026auto=format\u0026n=YpyW_DRIsi4t2IIc\u0026q=85\u0026s=3b0dd58e920bb636b305729a039f2eb5`,alt:`Medama Analytics Homepage`,\"data-og-width\":`960`,width:`960`,\"data-og-height\":`768`,height:`768`,\"data-path\":`img/demo.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/medama/YpyW_DRIsi4t2IIc/img/demo.png?w=280\u0026fit=max\u0026auto=format\u0026n=YpyW_DRIsi4t2IIc\u0026q=85\u0026s=6be266e9b90019855a5c8cf9325b33e0 280w, https://mintcdn.com/medama/YpyW_DRIsi4t2IIc/img/demo.png?w=560\u0026fit=max\u0026auto=format\u0026n=YpyW_DRIsi4t2IIc\u0026q=85\u0026s=1997207ebc09d6ded36554b63fe1e035 560w, https://mintcdn.com/medama/YpyW_DRIsi4t2IIc/img/demo.png?w=840\u0026fit=max\u0026auto=format\u0026n=YpyW_DRIsi4t2IIc\u0026q=85\u0026s=2b2f789991316be4e971e2cd882dadd5 840w, https://mintcdn.com/medama/YpyW_DRIsi4t2IIc/img/demo.png?w=1100\u0026fit=max\u0026auto=format\u0026n=YpyW_DRIsi4t2IIc\u0026q=85\u0026s=83cd82ce085a15785c652abd3d1d0e13 1100w, https://mintcdn.com/medama/YpyW_DRIsi4t2IIc/img/demo.png?w=1650\u0026fit=max\u0026auto=format\u0026n=YpyW_DRIsi4t2IIc\u0026q=85\u0026s=b144f4e49b728c3e24d810837cdb702b 1650w, https://mintcdn.com/medama/YpyW_DRIsi4t2IIc/img/demo.png?w=2500\u0026fit=max\u0026auto=format\u0026n=YpyW_DRIsi4t2IIc\u0026q=85\u0026s=c281bbbb7392ad5331c34bf942be1a3b 2500w`}),`\n`,_jsxs(Info,{children:[`We recommend checking out our `,_jsx(_components.a,{href:`https://demo.medama.io`,children:`Demo Dashboard`}),` to fully understand what data is collected and how it is displayed.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Page Views","description":null,"href":"/features/page-views"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"medama","siteName":"Medama Analytics","title":"Page Views - Medama Analytics","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-06T23:44:04.633Z","originalFileLocation":"features/page-views.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Medama Analytics\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/medama/VvF09eeqgFkQI8yS/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/medama/VvF09eeqgFkQI8yS/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/medama/VvF09eeqgFkQI8yS/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/medama/VvF09eeqgFkQI8yS/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/medama/VvF09eeqgFkQI8yS/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/medama/VvF09eeqgFkQI8yS/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/medama/VvF09eeqgFkQI8yS/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/medama/VvF09eeqgFkQI8yS/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/medama/VvF09eeqgFkQI8yS/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Page Views - Medama Analytics\">\u003cmeta data-mint-head property=\"og:description\" content=\"Medama Analytics is an open-source project dedicated to providing self-hostable, cookie-free website analytics. With a lightweight tracker of less than 1KB, it aims to offer useful analytics while prioritising user privacy.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Medama Analytics\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://medama.mintlify.app/features/page-views\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://medama.mintlify.site/img/demo.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Page Views - Medama Analytics\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Medama Analytics is an open-source project dedicated to providing self-hostable, cookie-free website analytics. With a lightweight tracker of less than 1KB, it aims to offer useful analytics while prioritising user privacy.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://medama.mintlify.site/img/demo.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/medama/VvF09eeqgFkQI8yS/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Medama Analytics\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#17cd8c\">\u003cmeta data-mint-head name=\"og:logo\" content=\"/logo/banner-dark.svg\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@ayuhitoo\">\u003clink data-mint-head rel=\"canonical\" href=\"https://medama.mintlify.app/features/page-views\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/features/page-views.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://medama.mintlify.app/#organization\",\"name\":\"Medama Analytics\",\"url\":\"https://medama.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/medama/YpyW_DRIsi4t2IIc/logo/banner-light.svg?fit=max\u0026auto=format\u0026n=YpyW_DRIsi4t2IIc\u0026q=85\u0026s=27047cdf1925c2658f0c2352de238d39\"}},{\"@type\":\"WebSite\",\"@id\":\"https://medama.mintlify.app#website\",\"name\":\"Medama Analytics\",\"url\":\"https://medama.mintlify.app\",\"publisher\":{\"@id\":\"https://medama.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://medama.mintlify.app/features/page-views#webpage\",\"url\":\"https://medama.mintlify.app/features/page-views\",\"name\":\"Page Views\",\"dateModified\":\"2026-01-06T23:44:04.633Z\",\"isPartOf\":{\"@id\":\"https://medama.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://medama.mintlify.app/features/page-views#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://medama.mintlify.app/features/page-views#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Medama Analytics\",\"item\":\"https://medama.mintlify.app\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Page Views\",\"item\":\"https://medama.mintlify.app/features/page-views\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://medama.mintlify.app/features/page-views#article\",\"headline\":\"Page Views\",\"name\":\"Page Views\",\"url\":\"https://medama.mintlify.app/features/page-views\",\"mainEntityOfPage\":{\"@id\":\"https://medama.mintlify.app/features/page-views#webpage\"},\"image\":\"https://medama.mintlify.app/img/demo.png\",\"dateModified\":\"2026-01-06T23:44:04.633Z\",\"publisher\":{\"@id\":\"https://medama.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://medama.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Medama Analytics\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Medama Analytics","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open-cover","groups":[{"group":"Get Started","pages":[{"title":"Introduction","description":null,"href":"/introduction"}]},{"group":"Features","pages":[{"title":"Page Views","href":"/features/page-views"},{"group":"Custom Properties","pages":[{"title":"Overview","description":null,"href":"/features/custom-properties/overview"},{"title":"Page Events","href":"/features/custom-properties/page-events"},{"title":"Click Events","href":"/features/custom-properties/click-events"}]}]},{"group":"Methodology","pages":[{"title":"Overview","href":"/methodology/overview"},{"group":"Data Collection","pages":[{"title":"Metrics","href":"/methodology/metrics"},{"title":"Unique Visitors","href":"/methodology/unique-visitors"},{"title":"Location","href":"/methodology/location"},{"title":"Bounce Rate","href":"/methodology/bounce-rate"}]}]},{"group":"Deployment","pages":[{"title":"Installation","href":"/deployment/installation"},{"group":"Guides","pages":[{"title":"Single Binary","href":"/deployment/single-binary"},{"title":"Docker","href":"/deployment/docker"},{"title":"Fly.io","href":"/deployment/fly"},{"title":"Railway","href":"/deployment/railway"},{"title":"Automatic SSL Setup","href":"/deployment/ssl"}]}]},{"group":"Configuration","pages":[{"title":"CLI","href":"/config/cli"},{"title":"Environment Variables","href":"/config/environment-variables"},{"title":"Tracking Snippet","href":"/config/tracking-snippet"}]}]},{"anchor":"API Reference","icon":"code","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"anchor":"Demo","href":"https://demo.medama.io","icon":"laptop"},{"anchor":"Discord","href":"https://medama.io/discord","icon":"discord"},{"anchor":"GitHub","href":"https://github.com/medama-io/medama","icon":"github"}]},"basePath":"","title":"Page Views - Medama Analytics","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-DMoL6lHz.js","lightbox-handle-r17bVUz3.js"]}