Documentation / Importing Historical Data
Importing Historical Data
Bring your historical pageview data into GhostlyX from any supported analytics platform. Imports are additive and privacy-safe. Available on the Scale plan.
Scale plan required
Historical data import is available on the Scale plan. Site owners and admins can upload imports. Viewers and editors do not have access to the import tool.
How importing works
GhostlyX accepts a CSV file exported from your previous analytics provider. It reads each row, strips any personal data, and writes the aggregated pageview counts into your site's historical data. Imports are additive: rows are appended alongside your live tracking data, never replacing it.
Export from your old tool
Follow the platform-specific guide below to export the correct report as a CSV file.
Upload in your dashboard
Go to your site, click Import Data, select your source, and upload the file.
Data appears in your charts
GhostlyX processes the file in the background. Historical bars appear in your dashboard once complete.
Privacy-safe processing
GhostlyX only reads aggregate pageview counts and page paths from your CSV. It does not import user IDs, IP addresses, client IDs, session tokens, or any other personal identifiers. Query strings are stripped from imported URLs (UTM parameters are kept for source attribution). Your uploaded CSV is deleted from storage immediately after processing completes.
Supported platforms
Select your previous analytics provider below for a step-by-step export and import guide.
Google Analytics 4
Export the Pages report from GA4 Explore or the standard Pages and screens report.
Universal Analytics (GA3)
Export the All Pages report from the Behaviour section before your property is deleted.
Plausible
Export your pages data from the Plausible dashboard using the built-in CSV export.
Fathom
Download a full CSV export from your Fathom site settings and upload it here.
Matomo
Export the Pages report from Behaviour (not the Channels report) in your Matomo dashboard.
Simple Analytics
Use the Simple Analytics data export feature to download your pages CSV.
Generic CSV
Already have a CSV export from another tool? Use the generic format guide to map your columns.
Limits and behaviour
Troubleshooting
My import completed but 0 rows were imported
This usually means the wrong report was exported. Each platform has a specific report that must be used. The most common mistake is exporting a Channels or Acquisition report instead of a Pages report. The importer expects rows with page paths (starting with /) in the path column. Check the platform-specific guide for the exact report name and export steps.
My import shows a failed status
The import job failed to process the file. This can happen if the CSV is malformed, uses an unexpected encoding, or the file was corrupted during upload. Try re-exporting from your analytics tool and uploading again. If the problem persists, contact support.
The import is stuck at 0% or processing for a long time
Large files can take several minutes to process. Refresh the page to see the latest progress. If the import has been stuck for more than 30 minutes, the job may have failed silently. Delete the import and try uploading again.
I uploaded the same file twice by mistake
GhostlyX does not deduplicate imported rows. If you uploaded the same file twice, your pageview counts will be doubled for the affected pages and dates. Delete the duplicate import from the import history to remove those rows.
My CSV file is rejected at upload
Check that the file is a valid CSV (not an Excel .xlsx file), is under 100 MB, and is UTF-8 encoded. Some platforms offer XLS or XLSX exports by default. Look for a CSV or plain text export option instead.