---
title: "Import Plausible Analytics Data into HitKeep | HitKeep"
description: "Export a Plausible ZIP from Settings, then import historical Plausible analytics into HitKeep with validation."
canonical: "https://hitkeep.com/guides/data/import-plausible/"
---

# Import Plausible Analytics Data into HitKeep

HitKeep imports Plausible history from Plausible’s CSV export ZIP. In Plausible, open the site settings, go to **Imports & exports**, then download the ZIP from **Export data**. In HitKeep, use the **Imports** page for the destination site.

## 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.

Use the full export for best data quality

Upload the Plausible ZIP when you can. If you upload loose CSV files, include every CSV from the export instead of selecting only one or two reports. Complete exports let HitKeep validate cross-file coverage, import more dimensions, preserve custom event data, and show fewer imported-data limitation warnings later.

## Export From Plausible

1. Open Plausible and select the site.
2. Go to **Settings**.
3. Open **Imports & exports** in the sidebar.
4. Find **Export data**.
5. Download the generated `.zip` file.

![Plausible Imports and exports settings showing the Export data ZIP download option](https://hitkeep.com/_astro/plausible_export.CjNWANmd_Z2ij2GS.webp)

Use the ZIP download in Plausible’s Imports and exports settings. Dashboard table exports do not contain the full import schema HitKeep expects.

Use the ZIP from **Export data** 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

1. In HitKeep, select the destination site.
2. Open **Imports** 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 Imports page showing Plausible and Simple Analytics importer choices](https://hitkeep.com/_astro/imports-plausible-provider.CHx4-v6B_ZGzwmm.webp)

Open **Imports** 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](https://hitkeep.com/_astro/imports-plausible-zip-review._1zRaegh_k88Cr.webp)

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

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:

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

Start the import after reviewing the manifest:

```
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:

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

## What HitKeep Imports

HitKeep imports compatible Plausible aggregate data into historical reports:

| Plausible data | HitKeep report data |
| --- | --- |
| Visitors and visits | Daily visitors, visits, pageviews, bounces, and visit duration |
| Pages | Top pages and page-level aggregates |
| Sources and UTM files | Sources and campaign-style breakdowns |
| Devices, browsers, OS, locations | Compatible dashboard dimensions |
| Custom events | Event names, totals, visitors, and timeseries |
| Event URL/path properties | Event 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

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](https://hitkeep.com/api/operations/tags/imports/).

## Related

- [Migration overview](https://hitkeep.com/guides/migration/)
- [Server-side tracking and historical replay](https://hitkeep.com/guides/tracking/server-side-tracking/)
- [Open exports and takeout](https://hitkeep.com/guides/data/takeout/)

[Previous Migration overview](https://hitkeep.com/guides/migration/)[Next Import Simple Analytics](https://hitkeep.com/guides/data/import-simple-analytics/)