Installation & Maintenance Configuration Analytics Features Analytics features (Premium) Videos Installation & Maintenance Matomo RequirementsRequired Configuration to Run MatomoRecommended ConfigurationMySQL User requirementsRecommended Web Hosts Matomo Installation & OptimizationGet Matomo Up and RunningOptimize & Secure MatomoMaintain Matomo Installing MatomoGetting StartedStart the InstallationThe 5-minute Matomo InstallationThe Welcome ScreenSystem CheckMySQL Database SetupSuper UserSet up Your First WebsiteInstall the JavaScript Tracking TagCongratulations!Configuring MatomoMedium and High-Traffic Websites: Setup an automated task (cron) to process reports Matomo IntegrationIntegrate Matomo with your CMS, Ecommerce Software, and MoreExport your data: Analytics Widgets Analytics API: fetch your data, integrate users, websites and more Customize Matomo Optimize and Scale MatomoWhat infrastructure do I need to run Matomo?Configure Matomo for speedGet Professional SupportMove your Matomo to the Cloud Managing your database’s sizeDeleting old unprocessed dataDeleting old reportsManually triggering a data purgeViewing reports about how your Matomo database size is used Update MatomoThe One-Click Matomo UpdateStep 1: Set Write Permissions on the Matomo folder with FTPClick on the Alert Box in MatomoRead the Message and Click Update AutomaticallyWatch the magic!Treat YourselfThe Manual Three-Step Update1) Back up your Configuration File2) Replace the Matomo files with the latest version3) Update MatomoDatabase Upgrade for High Traffic Matomo ServersNeed help to update your Matomo to the latest version?Troubleshooting Configuration Data Limits – No Limits Manage WebsitesAdd a WebsiteUpdate and Delete WebsitesTrack Subdomains & Multiple Domain NamesAll Websites DashboardThe All Websites Dashboard in Email ReportsEmbedding the All Websites Dashboard in your appCommon Questions Manage UsersCreate UsersManage User Access to WebsitesManage Super UsersAdvanced User Management Manage Email ReportsCreate and schedule a reportDownloading and sending your custom reports by emailSending Scheduled reports on TimeSend your key metrics as SMS text message Geo Locate your visitorsEnabling Accurate Visitors Geolocation in Matomo AnalyticsReports: Continent, Country, Region, City & ProviderMaintaining GeoIP DatabasesDetails & Resources How to Set up Auto-Archiving of Your ReportsLinux/Unix: How to Set up a Crontab to Automatically Archive the Reports.Windows: How to Set up Auto-Archiving Using Windows SchedulerCPanel: How to Set up the Cron Script Using CPanelWeb Cron When Your Web Host Does Not Support Cron TasksImportant Tips for Medium to High Traffic WebsitesDisable browser triggers for Matomo archiving and limit Matomo reports to updating every hourIncrease PHP Memory LimitMore High Traffic Server Tips!More Information About Matomo ArchivingHelp for core:archive command Matomo Analytics API Tracking APIJavascript client for Tracking APITracking API ClientsTracking API ReferenceUse case: Tracking data using the php clientImage Tracker codeMatomo Tracking API (Advanced users)More information How to use Log Analytics toolRequirementsDifferences using Log Analytics VS using Javascript clientHow to: run the Log File analysis script with default optionsHow to: import more data including bots, static files, and HTTP errors trackingHow to: exclude some particular log linesFrequently Asked Questions GDPRHow to make your use of Matomo GDPR compliantGDPR Resources Configure Privacy Settings in MatomoStep 1) Automatically Anonymize Visitor IPsStep 2) Delete Old Visitors LogsStep 3) Include a Web Analytics Opt-Out Feature on Your Site (Using an iFrame)Step 4) Respect DoNotTrack preferenceStep 5) Create a Privacy Policy page on your website(s)Step 6) Optional Privacy Preferences How to configure Matomo for security How to configure Matomo for speedConfigure Matomo for speedConfigure your server for speedConfigure your database server for speedOptimise your website tracking for speedResources Include & Customize Matomo for your Projectconfig/config.ini.php: The Matomo Config Filebootstrap.php: Execute Custom Code Before Matomo RunsLoad Matomo PHP classes and Call the API in PHPphp.ini and .htaccess notesUse a custom plugin, or build your own Embedding Matomo Reports in Other Websites or AppsChange User PermissionsEmbed a Matomo report in a HTML pageEmbed the Matomo dashboard in a HTML pageEmbed the full Matomo app anywhereEmbed a static image graph of your analytics dataCustomising the widgetsUsing the Reporting HTTP APIs to request any report data or raw dataMaking Matomo reports data publicly available Analytics Features A Tour of MatomoMatomo OverviewSelect a Date RangeA Look at a Matomo ReportDashboard & WidgetsCreating and customizing a new DashboardGraphs (Data Visualization)Inline helpFlattening reportsDetailed historical report about any data pointApplying Custom Segments to filter VisitorsVideos Showing the Power of Matomo! Track Goals and Measure ConversionsWhat is a Goal in Matomo?Examples of Useful GoalsCreate a GoalGoal Overview ReportGoal Detailed ReportReport Analysis: What are the Top Converting Segments?Conversion Funnel AnalysisAttribution Models Ecommerce AnalyticsEnable Ecommerce TrackingUsing a Matomo plugin for your Ecommerce SoftwareEcommerce Analytics reportsEcommerce Activity OverviewBest Products & Best CategoriesEcommerce Activity logSales by Marketing channelSales by country, city, regionPurchased products historical performanceEcommerce Metrics in Standard ReportsEcommerce trackingTracking Ecommerce Orders & Items Purchased (required)Tracking Add to Cart & Items Added to the Cart (optional)Tracking Product Page Views & Category Page Views (optional)Advanced Ecommerce Statistics API Row Evolution – View and compare historical dataAccessing the Row Evolution ReportNavigating the Row Evolution ReportComparing multiple row evolutionsRecording your insights Segmentation – Compare segments of visitorsCreating a segment in MatomoSwitching between segmentsRemoving segmentsUsing segments in e-mail reportsUseful segments you can createCustom segment: CustomersCustom segment: Returning customersCustom segment: Bounced visitsCustom segment: Mobile visitorsCustom segment: CommentersCustom segment: Visits from the region your business is located inCustom segment: Everyone who doesn’t bounceDetermining what to segmentFiguring out how to segment based on your objectivesFiguring out how to segment based on your dataSegments API Reference Event TrackingAnatomy of EventsViewing Events ReportsTracking EventsJavascript trackEvent()Tracking Events with HTTP APIRequesting Events report dataOther interactions Content TrackingViewing Content Tracking reportsContent Name reportContent Piece reportRequesting Content Tracking report dataTracking ContentTracking Content with HTTP API Site Search Tracking and ReportingEnable Site Search Tracking for your WebsiteTracking Site Search KeywordsTrack Site Search using URL Parameters (default)Track Site Search using the Javascript trackSiteSearch() functionTrack Site Search using the Tracking API (advanced users only)Tracking No Result Search KeywordsSite Search Analytics ReportsView the Detailed Searches for each VisitorNumber of searches and keywords over timeUnderstand How Site Search is Used to Find other Pages on your Site Visitors Maps – World, region, cityWorld Map showing Visits on forum.matomo.org by CountryVisitor Map showing Visits by RegionMap showing visits by CityHow to change the metric being plotted on the Map?World Map WidgetTroubleshooting Real Time Visitor World MapExample of the World map showing VisitorsDiscover the power of the Visitors Map!Visitor Maps WidgetAbout the maps Real Time AnalyticsThe Real Time Live! WidgetVisitor LogVisitor ProfileReal Time Analytics APIAbout Visitors’ Privacy The Visitor ProfileLaunching the Visitor ProfileVisitor Profile reportFeature OverviewAdvanced UsesDeveloper APISummary Site speed and Page speedOverall Website SpeedIndividual Page Generation SpeedMaking sure your website stays fastTracking page speed with each visit Transitions – Analyze the previous and following actions of your visitors for each pageHow to Open the Transitions Report for a Page?Understanding the Page Transitions ReportUsing & Interacting with the Transitions ReportConclusionResources Page Overlay – Visitors Click MapHow to Open Page Overlay for a Page?Understanding the User InterfaceConclusionPage Overlay Troubleshooting1. It doesn’t work at all2. Some links don’t have the bubbles3. I get the error “The Page Overlay session couldn’t be launched yet”4. I have multiple domains and it doesn’t show all data5. I have a high traffic website and it takes a long time until the bubbles appear Custom Variables AnalyticsWhat is a Custom Variable?When not to use Custom Variables?Tracking a Custom VariableCustom Variable ReportingCustom Variables in the Visitor LogUsage of your Custom Variables slotsData Limits for Custom VariablesReferences Custom DimensionsWhat is a Custom Dimension?Custom Dimension ReportingInstalling Custom DimensionsCreating Custom DimensionsTracking a Custom DimensionManaging Custom DimensionsUsing extractions to set a custom dimension valueDeactivating a DimensionSegmenting a Custom Dimension by Action typeData Limits for Custom DimensionsLearn more User IDAbout User IDImplementing User IDWhat is a User ID string?How do I generate a User ID?User ID with the JavaScript clientUser ID with another Tracker API clientUser ID with direct Tracker API accessUser ID reportBenefits of User IDHow requests with a User ID are trackedResources Annotating your dataWhy would I want to create annotations?Creating and editing annotationsThe Annotations API Tracking Marketing CampaignsAnalytics Campaign TrackingTracking Campaigns using URL ParametersCampaign URL GeneratorGoals & Ecommerce Campaign AttributionAttribution data is saved in a first party cookieFAQ: Tracking campaignsTracking more than two campaign dimensionsTracking Paid Search Ads URL Builder – Marketing Campaign Tracking Help resourcesUser guidesGlossaryFrequently Asked QuestionsDeveloper guidesUser TrainingCustom developmentFree supportEnterprise support subscriptions Analytics features (Premium) FunnelsViewing Funnel ReportsManaging your FunnelsConfiguring a funnelValidating a funnelActivating a FunnelFAQ Session RecordingsViewing Session RecordingsSession Recording ReportApplying segmentsReplaying a recorded sessionPlaying a recorded session from the Visitor LogManaging your Session RecordingsCreating and editing a session recordingAdvanced optionsTracking session recordingsFAQ Media AnalyticsViewing Media Analytics ReportsOverviewReal-time reportsDetailed Video and Audio reportsAudience Log & Audience MapTracking Videos & AudioFAQ HeatmapsViewing HeatmapsClick MapMouse Move / Hover MapScroll MapAbove the foldApplying segmentsDevicesManaging your HeatmapsCreating and editing a HeatmapAdvanced optionsTracking heatmapsFAQ A/B TestingViewing Experiment ReportsManaging your ExperimentsCreating an experimentAdjusting an experiment to your needsComparing performance of different Pages URLsStarting your experimentFinishing your experimentArchiving your experimentEmbedding / Tracking an experimentFAQ Custom ReportsViewing Custom ReportsExamples of custom reportsPerformance of pages broken down by minute.Events over 3 dimensionsRevenue per country filtered by mobile devicesPage URLs by UserReporting featuresFlatteningPivotingDifferent visualizationsManaging Custom ReportsCreating and editing a Custom ReportReport contentReport filterReport pageTesting a report configurationAdding a custom report widget to the dashboardSending custom reports by emailFAQ Form AnalyticsViewing Form ReportsOverviewReal-time ReportsForm ReportsForm SummaryPage URL reportField reportsDrop Off FieldsDifferent VisualizationsRow evolutionEntry fieldsField timingsField sizeMost used fieldsMost correctedUnneeded fieldsApplying segmentsManaging your FormsCreating and editing a formMatching your formsRestricting the tracking to certain pagesDefining form conversionsTracking your online and web formsFAQ Roll-Up ReportingWhen to use a Roll-Up siteManaging Roll-UpsViewing reports of Roll-UpsVisitor log and real time reportsRoll-Up site’s visitor log shows users across websitesReal time widget showing users across the Roll-Up websites Search Engine Keywords PerformanceViewing Search Keywords ReportsCombined KeywordsKeywords for Google Search, Google Images and Google VideosKeywords for Bing and Yahoo! SearchKeywords position in search engine over timeViewing Search Bots Crawl Overview reportsHow to import Google Search keywords in MatomoHow to set up Google Search Console and verify your websiteHow to set up Google OAuth Client configHow to import Bing and Yahoo! search keywords into Matomo?FAQ Users FlowViewing the Users Flow visualizationViewing the most popular paths and visitor engagementApplying segments Multi Channel Conversion AttributionViewing the Multi Channel Conversion Attribution ReportList of Multi-Channel Attribution ModelsManaging Multi AttributionFAQ Login with SAML AuthenticationInstallationRequirementsInstallationConfigurationSAML Configuration supportSAML plugin settingsStatus SettingsIdentity Provider SettingsOption settingsAttribute Mapping SettingsAccess Synchronization settingsManaging Access for Multiple Matomo InstancesUsing a custom access attribute formatAdvanced SettingsDebuggingHow does SAML plugin for Matomo work?SP-initiated SSO authentication processIdP-initiated SSO authentication processSP-initiated Single Logout authentication process (SLO enabled)IdP-initiated Single Logout authentication process (SLO enabled)Security Considerations Videos [Video] Welcome to Matomo Analytics [Video] How to Install Matomo Analytics Video [Video] Learn all about Matomo’s Analytics Features [Video] How to Configure Settings in Matomo Analytics [Video] Learn about your Visitors [Video] Referrers Reports [Video] Actions Reports [Video] Tracking Goals [Video] Email and SMS Reports