Documentation / Importing Historical Data / Matomo
Import from Matomo
Export the Pages report from the Behaviour section of Matomo and upload it to GhostlyX to carry across your historical pageview data.
You must export from Behaviour, not Acquisition
The most common import mistake with Matomo is exporting the Channels or Acquisition report instead of the Pages report. The Channels report uses channel names (Direct, Organic Search, etc.) as row labels, not page paths. The GhostlyX importer will silently skip all rows that do not start with a /, resulting in 0 rows imported. Always export from Behaviour (or Actions) > Pages.
Scale plan required
Historical data import is available on the Scale plan. You must be a site owner or admin to access the Import Data page.
Export the Pages report from Matomo
GhostlyX reads the Pages report, which is found under Behaviour (also labelled Actions in some Matomo versions). Do not export from Channels or Acquisition.
Open Matomo
Sign in to your Matomo instance and select the website you want to export data from.
Go to Behaviour (or Actions)
In the left sidebar, click Behaviour. In some Matomo versions this section is labelled Actions. Either works.
Click Pages
Under Behaviour (or Actions), click Pages. You should see a table with page paths (like /blog/) in the Label column. If you see channel names (like "Organic Search" or "Direct"), you are in the wrong section.
Set the date range
Use the date picker to select the full historical range you want to export. Then click Apply.
Show all rows
At the bottom of the table, increase the rows-per-page to the maximum available (typically 100 or 500). If you have more pages, you may need to export multiple pages of results.
Export as CSV
Click the Export icon at the top right of the Pages table and choose CSV. Save the file to your computer.
Expected CSV format (Pages report)
GhostlyX reads the Label and Unique Pageviews columns. The Label column must contain page paths starting with /.
Correct (Behaviour > Pages):
Label,Unique Pageviews,Pageviews,Bounce Rate,...
/,8320,12450,42%,...
/blog/,3100,4200,38%,...
/pricing/,1540,1980,55%,...
Wrong (Acquisition > Channels - do not use):
Label,Unique Pageviews,...
Organic Search,45200,...
Direct,18900,...
Referral,7400,...Upload to GhostlyX
Open your site dashboard
Go to your GhostlyX dashboard and open the site you are importing into.
Click Import Data
In the site toolbar, click the Import Data button.
Select source
Choose Matomo from the source dropdown.
Upload the CSV
Click Choose file, select the Matomo Pages CSV, and click Start import.
Wait for processing
The import runs in the background. Track progress on the Import Data page.
Common issues
0 rows imported
You almost certainly exported the Channels or Acquisition report instead of the Pages report. Open your CSV in a text editor and check whether the Label column contains values like "Organic Search" or "Direct". If so, go back to Matomo and export from Behaviour (or Actions) > Pages instead.
Matomo shows "Actions" not "Behaviour" in my version
Matomo renamed "Actions" to "Behaviour" in a later version. Both sections contain the Pages report. Look for "Pages" underneath whichever label your version uses.
My CSV contains sub-pages but they are not appearing
Matomo sometimes exports sub-pages in a hierarchical format with partial paths in the Label column. GhostlyX only imports rows where the Label starts with a / and represents a full page path. Make sure you are viewing the flat pages list, not a drilled-down sub-directory view.