> ## Documentation Index
> Fetch the complete documentation index at: https://tinyanalytics.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Import Plausible Analytics Data

> Upload a Plausible export to bring historical pageviews, sessions, sources, and countries into tinyanalytics alongside new traffic.

You can import your **Plausible** history into tinyanalytics by uploading a Plausible export file. tinyanalytics reconstructs your past traffic from the export and stores it as events, so your Plausible history appears in every report next to your new tinyanalytics data.

## How to import from Plausible

<Steps>
  <Step title="Export your data from Plausible">
    In Plausible, export your stats as a CSV file for the date range you want to keep.
  </Step>

  <Step title="Upload the file to tinyanalytics">
    In your site's import settings, choose **Plausible** and upload the export file. tinyanalytics parses it in your browser and imports the events.
  </Step>

  <Step title="See it in your dashboard">
    When the import finishes, your Plausible history is live across your reports.
  </Step>
</Steps>

<Check>
  The import worked when your Plausible history appears in your tinyanalytics reports, and the import summary shows how many events imported, skipped, or were invalid.
</Check>

## What carries over from Plausible — and what's approximate

A Plausible export contains daily totals per dimension rather than individual visits, so tinyanalytics reconstructs events from those aggregates. What that means for your data:

| Carries over                             | Approximate or unavailable                          |
| ---------------------------------------- | --------------------------------------------------- |
| Pageviews and sessions with daily totals | **Timestamps** are spread within each day           |
| Countries                                | **Cities** aren't available from a Plausible export |
| Sources, referrers, and campaigns        | **Page titles** and **language** aren't included    |
| Browsers, operating systems, devices     | **Screen size** isn't included                      |

**Channels are re-derived by tinyanalytics** from the source and campaign data, so imported Plausible traffic is classified by the same rules as your live traffic.

## Good to know

<Note>
  * **One import runs at a time per organization.**
  * **Rows dated in the future are skipped**, and malformed rows are dropped and counted, so you'll see how many events imported, skipped, or were invalid.
  * **Re-running adds the data again** — to redo an import, delete the previous one first (deleting removes all of that import's data).
  * Imported data is stored as ordinary events, so it flows through **every report**, including funnels, retention, cohorts, and [period comparison](/docs/analytics-period-comparison).
</Note>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Why are my imported Plausible timestamps spread through the day?">
    A Plausible export contains daily totals per dimension rather than individual visits, so tinyanalytics reconstructs events from those aggregates and spreads them within each day. Pageviews and sessions keep their daily totals.
  </Accordion>

  <Accordion title="What doesn't carry over from a Plausible export?">
    **Cities**, **page titles**, **language**, and **screen size** aren't in a Plausible export, so they aren't imported. Countries, sources, referrers, campaigns, browsers, operating systems, and devices do carry over.
  </Accordion>

  <Accordion title="How do I redo a Plausible import?">
    Delete the previous import first, then run it again. Re-running an import **adds** the data a second time rather than replacing it, and deleting an import removes all of that import's data. Only one import runs at a time per organization.
  </Accordion>

  <Accordion title="Are my imported Plausible channels the same as Plausible's?">
    No — **channels are re-derived by tinyanalytics** from the source and campaign data in your export. Imported Plausible traffic is classified by the same rules as your live tinyanalytics traffic.
  </Accordion>
</AccordionGroup>

## Related

<Columns cols={2}>
  <Card title="Switch to tinyanalytics" icon="right-left" href="/docs/migrate-analytics-data-to-tinyanalytics">
    The full migration overview.
  </Card>

  <Card title="Import from Umami" icon="file-import" href="/docs/import-umami-analytics-data">
    Coming from Umami instead.
  </Card>

  <Card title="Import from GA4" icon="google" href="/docs/import-google-analytics-4-data">
    Import Google Analytics history directly.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/docs/tinyanalytics-quickstart">
    Install the script to start collecting new data.
  </Card>
</Columns>


## Related topics

- [Import Umami Analytics Data](/docs/import-umami-analytics-data.md)
- [Import Simple Analytics Data](/docs/import-simple-analytics-data.md)
- [Import Google Analytics 4 Data](/docs/import-google-analytics-4-data.md)
