Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions docs/data-access.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Plausible gives you several ways to access your stats outside the dashboard. The
| Download stats as a spreadsheet, one-off | [CSV export](#csv-export) |
| Build a custom report in Google's visualization tool | [Data Studio](#data-studio) |
| Pipe data into a data warehouse or BI tool | [Warehouse connectors](#data-warehouse-connectors) |
| Get event-level data for warehousing or compliance | [Scheduled raw exports](#scheduled-raw-event-exports) |
| Get event-level data for warehousing or compliance | [Scheduled raw event data exports](#scheduled-raw-event-data-exports) |
| Query data in natural language through AI tools | [MCP server](#mcp-server) |
| View stats from a mobile or desktop app | [Mobile and desktop apps](data-pipelines.md) |

Expand Down Expand Up @@ -104,17 +104,17 @@ For the full list of community connectors, apps and integrations, see [Viewing P

---

## Scheduled raw event exports
## Scheduled raw event data exports

For cases where aggregated stats are not enough, Plausible offers scheduled raw event data exports. These give you access to event-level data delivered automatically on an agreed schedule, in a format and schema configured with our team.
For cases where aggregated stats are not enough, Plausible offers scheduled raw event data exports. These give you access to event- and session-level data delivered daily to your S3-compatible object storage, in a format and schema configured with our team.

**Use this when:**
- You need event-level data for data warehousing, internal analytics or compliance reporting
- Aggregated stats from the CSV export or Stats API do not meet your needs

Raw event exports are not self-serve and are not real-time. They are part of our [Enterprise plans](https://plausible.io/enterprise-web-analytics). [Contact us](https://plausible.io/contact) to discuss your needs.
Raw event data exports are not self-serve and are not real-time. They are part of our [Enterprise plans](https://plausible.io/enterprise-web-analytics). [Contact us](https://plausible.io/contact) to discuss your needs.

[Scheduled raw event exports](raw-data-export.md)
[Scheduled raw event data exports](raw-data-export.md)

---

Expand Down
4 changes: 3 additions & 1 deletion docs/export-stats.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,8 @@ As an alternative to exporting as CSV files or if you prefer a programmatic way

## Scheduled raw event data exports

If you need event-level data rather than aggregated stats, Plausible offers scheduled raw event exports as part of our [Enterprise plans](https://plausible.io/enterprise-web-analytics). These cover advanced use cases such as data warehousing, internal analytics and compliance reporting.
If you need event-level data rather than aggregated stats, Plausible offers scheduled raw event data exports as part of our [Enterprise plans](https://plausible.io/enterprise-web-analytics). These cover advanced use cases such as data warehousing, internal analytics and compliance reporting.

Exports are delivered daily to your S3-compatible object storage. See the full guide for example Parquet files, supported formats and the policy on historical backfills.

[See full details, use cases and how to get started →](raw-data-export.md)
45 changes: 38 additions & 7 deletions docs/raw-data-export.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,54 @@
---
displayed_sidebar: someSidebar
title: Scheduled raw event exports
description: "Get event-level data from Plausible delivered automatically on a schedule. For data warehousing, compliance and internal analytics where aggregated stats are not enough."
title: Scheduled raw event data exports
description: "Get event-level data from Plausible delivered automatically every day. For data warehousing, compliance and internal analytics where aggregated stats are not enough."
---

import PlanFeatureNote from '@site/src/components/PlanFeatureNote';

<PlanFeatureNote feature="raw-data-export" plan="enterprise" label="Scheduled raw event exports" />
<PlanFeatureNote feature="raw-data-export" plan="enterprise" label="Scheduled raw event data exports" />

The Stats API and CSV export give you aggregated data: totals, breakdowns and time series across your sites. For cases where you need the underlying event-level data, Plausible offers scheduled raw event exports.
The Stats API and CSV export give you aggregated data: totals, breakdowns and time series across your sites. For cases where you need the underlying event-level data, Plausible offers scheduled raw event data exports.

## What it is

A scheduled raw export delivers event-level data from your Plausible account automatically, on an agreed schedule. Setup is configured with our team: we agree on the event data fields and schema, the export format (CSV or Parquet), the delivery interval (daily, weekly or other) and the delivery destination. We support uploading directly to your S3 bucket or Google Cloud Storage bucket. Once configured, exports are delivered automatically with no action needed on your end.
A scheduled raw export delivers event- and session-level data from your Plausible account to your object storage every day.

Unlike the Stats API, which returns pre-aggregated results, raw exports give you individual event records. This lets you run your own aggregations, apply custom attribution models, join analytics data with other business data, and meet compliance requirements that call for event-level audit trails.
Setup is configured with our team: we agree on the data fields and schema, the delivery destination and whether the export uses CSV, Parquet or JSON Lines (JSONL).

We can deliver to any S3-compatible object storage service, including AWS S3 and Google Cloud Storage. Once configured, exports are delivered daily with no action needed on your end.

Unlike the Stats API, which returns pre-aggregated results, raw exports give you individual event records.

This lets you run your own aggregations, apply custom attribution models, join analytics data with other business data, and meet compliance requirements that call for event-level audit trails.

Raw exports are intentionally scoped to keep Plausible fast, privacy-friendly and predictable. They are not real-time and not self-serve.

## Explore an example export

Download an example export for plausible.io covering July 2026:

- [events.parquet](https://edlvc.upcloudobjects.com/plausible-io-example/2026-07/events.parquet) contains the individual event records
- [sessions.parquet](https://edlvc.upcloudobjects.com/plausible-io-example/2026-07/sessions.parquet) contains the sessions those events belong to

Use these files to inspect the Parquet schema and example values before planning how you will load the data into your own systems.

## What's included

Alongside the event-level file, exports include a companion session-level file, so you get both individual events and the sessions they belong to.

Custom properties are delivered as a single JSON object per row rather than a fixed set of columns, so you don't need to declare property names in advance and can change your instrumentation over time without breaking the export schema.

Plausible-generated identifiers are an anonymous session ID and a daily-rotating anonymous user ID used for unique-visitor calculations.

Delivery to Google Cloud Storage goes through GCS's S3-compatible endpoint using static (HMAC) credentials, the same as an S3 bucket. Authenticating with a native GCP service account isn't supported out of the box.

## Historical data and backfills

Daily exports start after setup. Historical backfills are not included by default. Because backfills are prepared manually, only short backfills may be possible case by case.

If you need historical data, include the date range when contacting us so we can confirm what is possible.

## When to use it

Raw exports are the right choice when:
Expand All @@ -41,4 +72,4 @@ Before requesting raw exports, check whether a simpler option covers your needs:

## How to get it

Raw event exports are part of our [Enterprise plans](https://plausible.io/enterprise-web-analytics) and are not self-serve. [Contact us](https://plausible.io/contact) to discuss your data volume, delivery schedule and format requirements.
Raw event data exports are part of our [Enterprise plans](https://plausible.io/enterprise-web-analytics) and are not self-serve. [Contact us](https://plausible.io/contact) to discuss your data volume, export format, storage provider and any historical date range you need.
2 changes: 1 addition & 1 deletion docs/subscription-plans.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Enterprise includes everything in Business plus additional features and higher l
- **SSO (Single Sign-On)**: log in via your existing identity provider using SAML 2.0. See [SSO documentation](sso.md).
- **Sites API**: create and manage sites programmatically. See [Sites API documentation](sites-api.md).
- **Managed proxy**: we handle the proxy setup and maintenance for you. See [proxy options](proxy/introduction.md).
- **Scheduled raw event exports**: event-level data delivered automatically on an agreed schedule. See [raw event exports](raw-data-export.md).
- **Scheduled raw event data exports**: event- and session-level data delivered daily to your S3-compatible object storage. See [raw event data exports](raw-data-export.md).

Limits that can be increased on Enterprise beyond standard plan tiers:

Expand Down
Loading