Skip to content
HitKeep
Start free in HitKeep Cloud
Select language
Select theme
GitHub
Start free in Cloud
Switching from Simple Analytics?Explore HitKeep

Import Plausible Analytics Data into HitKeep

HitKeep imports Plausible history from its complete CSV export, either as a ZIP or as loose CSV files. Request the full export from Plausible’s site settings, then use Integration → Import & Export for the destination site in HitKeep. Follow Plausible’s current export instructions if its interface differs from the steps below.

Before You Export

Section titled “Before You Export”

You need access to the Plausible site and site.manage_data access for the destination HitKeep site.

The normal Plausible export is a ZIP file that contains CSV files with schemas for traffic, pages, sources, UTM data, devices, locations, custom events, and custom properties. Plausible usually names those files like:

imported_visitors.csv
imported_pages.csv
imported_sources.csv
imported_custom_events.csv
imported_custom_props.csv

HitKeep accepts either the ZIP file directly or loose .csv files from an unpacked archive. Loose CSV filenames do not have to start with imported_. HitKeep reads the header row and imports the file when the columns match a supported Plausible export schema.

Export From Plausible

Section titled “Export From Plausible”
  1. Open Plausible’s Sites page and select Settings for the site.
  2. Open Imports & Exports and find Export Data.
  3. Select Export to CSV to request the complete native export.
  4. Wait for Plausible’s email, then download the export within 24 hours of it becoming ready.
  5. Keep the CSV files together. If the download is a ZIP, you can upload it directly to HitKeep.

Plausible’s complete site-settings export excludes data previously imported from other products. Export that history from its original source separately if you need to preserve it. The dashboard’s report export is a different, capped reporting format; use the complete site-settings export for this migration.

Use the complete site-settings export rather than a dashboard table export. HitKeep expects Plausible’s import/export CSV schemas, including daily aggregate rows and event files when they exist. Keep the ZIP intact for the highest-quality import, or keep all of the CSV files together if you unpack it.

Import Into HitKeep

Section titled “Import Into HitKeep”
  1. In HitKeep, select the destination site.
  2. Open Integration → Import & Export from the left navigation.
  3. Choose Plausible as the importer.
  4. Upload the Plausible ZIP, or upload all loose .csv files from the export.
  5. Run validation and review the manifest.
  6. Start the import after the summary matches the data you expect.
HitKeep Import tab showing Plausible and Simple Analytics importer choices
Open Integration → Import & Export in HitKeep, then choose the Plausible importer for the destination site.
HitKeep Plausible import validation manifest with accepted rows, files, date range, datasets, and import history
Review the validation manifest before starting the import. The summary shows accepted rows, skipped rows, source files, date range, datasets, and warnings.

The import writes to the currently selected HitKeep site. If you manage multiple sites, check the site switcher before uploading the ZIP.

Unsupported CSV schemas are ignored with a warning when the upload also contains recognized Plausible files. Validation fails when none of the uploaded CSV headers match a supported Plausible schema.

CLI Import

Section titled “CLI Import”

The CLI reuses HITKEEP_PUBLIC_URL when it is already set, and otherwise talks to http://localhost:8080. Pass --url only when running the command from a different machine.

Validate the Plausible ZIP before importing:

Terminal window
hitkeep import validate plausible --site <site-id> --file plausible-export.zip

Start the import after reviewing the manifest:

Terminal window
hitkeep import plausible --site <site-id> --file plausible-export.zip --wait

If the export has already been unpacked, import the whole directory so HitKeep can scan every exported CSV:

Terminal window
hitkeep import validate plausible --site <site-id> --dir ./plausible-export
hitkeep import plausible --site <site-id> --dir ./plausible-export --wait

What HitKeep Imports

Section titled “What HitKeep Imports”

HitKeep imports compatible Plausible aggregate data into historical reports:

Plausible dataHitKeep report data
Visitors and visitsDaily visitors, visits, pageviews, bounces, and visit duration
PagesTop pages and page-level aggregates
Sources and UTM filesSources and campaign-style breakdowns
Devices, browsers, OS, locationsCompatible dashboard dimensions
Custom eventsEvent names, totals, visitors, and timeseries
Event URL/path propertiesEvent property breakdowns where the export proves the relationship

Plausible exports are aggregate CSV files. They do not contain raw sessions, hourly events, or event-level source/browser/device/country/language relationships. HitKeep shows imported data in compatible reports and reports an exclusion reason when a view needs relationships the export cannot prove.

After Import

Section titled “After Import”

Open the destination site’s dashboard and select the imported date range. Imported Plausible traffic appears in compatible historical dashboard views. Imported custom events appear in the Events dashboard when the export includes custom event rows.

For API automation, use the import endpoints under the Imports API reference.

Section titled “Related”