Migration Guide
Import historical traffic into Beam
When you migrate from Plausible or Fathom, you do not have to start from zero. Beam supports CSV-based daily traffic import so your dashboard shows historical trend context from the moment you go live. This guide explains exactly what the import covers, how to do it, and what it intentionally does not backfill.
What this import gives you
- ✓Daily pageview and visitor totals covering the date range in your exported CSV — enough to see traffic trends at a glance.
- ✓No double-counting — Beam always uses native data for days it has collected pageviews. Imported totals only fill days with no Beam events.
- ✓Import coverage banner in your dashboard showing exactly which date range comes from imported history vs. live Beam collection.
- —Not a raw-event backfill — top pages, referrers, and country breakdowns for historical dates are not restored. Only daily aggregate totals (pageviews + visitors) are imported.
Supported sources
| Source | Supported | Notes |
|---|---|---|
| Plausible Analytics | Yes | Export daily stats CSV from Plausible dashboard → Settings → Export. Use the "All time" date range. |
| Fathom Analytics | Yes | Export the daily stats CSV from Fathom dashboard → Reports → Export CSV. Use the widest date range available. |
| Google Analytics | Not yet | GA4 export format is not currently supported. |
| beamanalytics.io | Not yet | Direct import from beamanalytics.io exports is not yet supported. |
Step-by-step import guide
-
1. Export daily stats from your old tool
In Plausible, go to Settings → Export → Download CSV and select "All time" to get the full history. In Fathom, go to Reports → Export CSV with the widest date range. Save the file locally.
-
2. Create a site in Beam (if you haven't already)
Sign up, add your domain, and install the tracking snippet so live pageviews start arriving. You can import history before or after the live snippet is installed.
-
3. Open your site's Migration tab in the dashboard
In the Beam dashboard, navigate to your site → Migration tab. You will see import cards for supported sources.
-
4. Upload the CSV and wait for processing
Select the matching import card (Plausible or Fathom), upload your CSV, and submit. Processing is typically instant for standard export sizes. You will see a success or failure status with a row count.
-
5. Check the import coverage banner
Open your site's analytics view. A coverage banner will show the imported date range and confirm that native Beam data takes priority wherever both exist.
Honest scope: what this import does not restore
- Individual pageview events or session-level history — only daily totals (pageviews + visitors per day).
- Top pages, referrers, country, browser, or device breakdowns for imported dates.
- Custom event history or goal conversion data from your old tool.
- Automatic or one-click import — you need to export and upload the CSV manually.
This is intentional: daily totals give you the trend signal that matters for growth decisions without requiring raw PII backfill.
Ready to bring your history?
Create your Beam account, set up your site, and use the Migration tab to upload your CSV export.