Reports & Exports

Export your analytics data, create custom reports, and schedule automated email summaries of your website performance.

Plausible provides flexible reporting and data export options to help you share insights, analyze trends, and integrate analytics data with other tools.

Export Formats

Export your analytics data in multiple formats:

CSV Export

Download any dashboard view as CSV for spreadsheet analysis

Stats API

Programmatic access to all metrics and breakdowns

Email Reports

Scheduled reports delivered to your inbox

Shared Links

Public or password-protected dashboard access

CSV Exports

Download your analytics data for offline analysis:

Exporting Data

1. Configure Your View

   Set up the dashboard view you want to export:

   • Select date range
   • Apply filters
   • Choose metrics
   • Apply segments
2. Click Export

   Click the “Export” or “Download CSV” button in your dashboard.

3. Choose Data

   Select what to export:

   • Top pages
   • Traffic sources
   • Geographic data
   • Device statistics
   • Goal conversions
   • Custom breakdowns
4. Download File

   Your CSV file downloads immediately, ready for use in:

   • Excel or Google Sheets
   • Data analysis tools
   • Business intelligence platforms
   • Custom reporting systems

CSV Data Structure

Exported files include:

date,visitors,pageviews,bounce_rate,visit_duration
2024-03-01,1523,4891,42.5,156
2024-03-02,1687,5234,39.8,168
2024-03-03,1456,4567,45.2,142

CSV exports respect all applied filters and date ranges, giving you exactly the data you see on your dashboard.

What You Can Export

Aggregate Metrics:

• Visitors, visits, pageviews
• Bounce rate, visit duration
• Views per visit
• Conversion rates
• Revenue metrics (Business plan)

Breakdown Data:

• Top pages with metrics
• Traffic sources with conversion data
• Geographic breakdown (country, city, region)
• Device, browser, OS statistics
• Entry and exit pages
• UTM campaign performance

Time Series:

• Daily, weekly, or monthly trends
• Hour-by-hour data for shorter ranges
• Historical comparisons

Email Reports

Receive automated analytics summaries via email:

Report Types

Weekly Reports

Every Monday, receive a summary of the previous week:

• Total visitors
• Pageviews
• Top pages
• Top sources
• Comparison with previous week

Monthly Reports

First day of each month, get the previous month’s performance:

• Monthly visitor trends
• Best performing content
• Traffic source breakdown
• Month-over-month comparison

Configuring Email Reports

1. Go to Site Settings

   Navigate to your site settings page.

2. Email Reports Section

   Find the “Email Reports” or “Weekly/Monthly Reports” section.

3. Enable Reports

   Toggle on the reports you want:

   • Weekly report
   • Monthly report
   • Both
4. Add Recipients

   Enter email addresses for report recipients (team members or stakeholders).

Email Report Content

Reports include:

Summary Metrics:

• Unique visitors
• Total pageviews
• Bounce rate
• Visit duration
• Percentage change from previous period

Top Performers:

• Most visited pages (top 5)
• Best traffic sources (top 5)
• Top countries (top 3)

Visual Elements:

• Traffic trend graph
• Key metric comparisons
• Up/down indicators

Email reports are sent to all configured recipients. Team members can opt out individually from their user preferences.

Shared Links

Create shareable dashboard links for stakeholders:

Creating Shared Links

1. Navigate to Shared Links

   Go to Site Settings → Shared Links.

2. Create New Link

   Click “New Link” to create a shared dashboard:

   • Name: Descriptive name for the link
   • Password: Optional password protection
   • Segment: Apply a segment filter (optional)
3. Copy Link

   Copy the generated URL and share with:

   • Clients
   • Team members without accounts
   • Stakeholders
   • Partners

Shared Link Options

Public Links:

• No password required
• Anyone with the URL can view
• Useful for transparent reporting
• Can be indexed by search engines if not careful

Password Protected:

• Require password to access
• Additional security layer
• Share password separately
• Suitable for sensitive data

Segment Filtering:

• Apply saved segment to shared view
• Limit what data is visible
• Create focused reports for specific stakeholders

Shared links provide read-only access to your analytics. Recipients cannot modify settings, but they can see all data within the shared view.

Managing Shared Links

• Edit: Change name, password, or segment
• Revoke: Disable link immediately
• Regenerate: Create new URL if compromised
• Track Usage: See when links were last accessed

Stats API

Programmatic access to all your analytics data:

API Capabilities

The Stats API provides:

• Aggregate Metrics: Get overall statistics for any period
• Time Series: Retrieve trends over time
• Breakdowns: Drill down by any dimension
• Real-time: Access current visitor data
• Custom Queries: Combine filters, metrics, and dimensions

Example API Calls

Get aggregate stats:

curl https://plausible.io/api/v2/query \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "site_id": "yourdomain.com",
    "metrics": ["visitors", "pageviews", "bounce_rate"],
    "date_range": ["2024-03-01", "2024-03-31"]
  }'

Get breakdown by source:

curl https://plausible.io/api/v2/query \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "site_id": "yourdomain.com",
    "metrics": ["visitors", "visits"],
    "date_range": "last_30_days",
    "dimensions": ["visit:source"]
  }'

The Stats API uses your same analytics data with no sampling. Perfect for building custom dashboards, integrations, or automated reporting.

API Authentication

Secure your API access:

1. Generate API key in account settings
2. Include in Authorization header
3. Keep key secure (never commit to code)
4. Rotate keys periodically

Rate Limits

API requests are rate-limited:

• Standard: 600 requests per hour
• Spike tolerance: Short bursts allowed
• 429 errors: Wait before retrying

Custom Reporting Solutions

Build custom reports using Plausible data:

Data Warehouse Integration

Export data to your data warehouse:

1. Schedule API Calls

   Set up automated scripts to fetch data daily/weekly.

2. Transform Data

   Process API responses into your warehouse schema.

3. Join with Other Data

   Combine Plausible analytics with:

   • CRM data
   • Sales information
   • Product metrics
   • Customer data
4. Create Reports

   Build comprehensive reports across all your data sources.

Business Intelligence Tools

Connect Plausible to BI platforms:

• Google Data Studio: Create custom dashboards
• Tableau: Build visual analytics
• Power BI: Enterprise reporting
• Metabase: Open-source analytics

Automated Alerts

Build alert systems:

# Example: Alert on traffic drop
import requests

response = requests.post(
    'https://plausible.io/api/v2/query',
    headers={'Authorization': 'Bearer YOUR_KEY'},
    json={
        'site_id': 'yourdomain.com',
        'metrics': ['visitors'],
        'date_range': 'day',
        'compare': 'previous_period'
    }
)

data = response.json()
if data['results'][0]['change'] < -20:  # 20% drop
    send_alert('Traffic dropped significantly!')

Report Best Practices

Regular Cadence

Establish consistent reporting schedule (weekly or monthly).

Relevant Metrics

Focus on metrics that matter to your stakeholders.

Context Matters

Include comparison periods and explain changes.

Secure Sharing

Use password protection for sensitive data.

Data Ownership

Your data belongs to you:

• Export Anytime: Download all your data whenever needed
• No Lock-in: Full data portability
• API Access: Programmatic access to all metrics
• Data Deletion: Request complete data removal

Privacy in Reports

Reporting respects privacy:

• No personal data exposed in exports
• Aggregated statistics only
• No individual visitor tracking
• GDPR-compliant data handling

Advanced Export Options

Filtered Exports

Export specific subsets:

• Apply filters before exporting
• Use segments for consistent exports
• Combine multiple filters
• Save export configurations

Comparison Exports

Include comparison data:

• Period-over-period changes
• Year-over-year trends
• Percentage changes
• Absolute differences

Scheduled Exports

Automate data exports:

• Use API with cron jobs
• Schedule daily/weekly exports
• Store in cloud storage
• Feed into other systems

Troubleshooting

CSV export incomplete

• Large exports may be truncated
• Use API for complete data sets
• Split exports by date range
• Contact support for very large exports

Email reports not arriving

• Check spam folder
• Verify email address is correct
• Confirm reports are enabled
• Check team member preferences

Shared link not working

• Verify link hasn’t been revoked
• Check password if protected
• Clear browser cache
• Try incognito/private mode

API rate limit errors

• Reduce request frequency
• Implement exponential backoff
• Cache responses when appropriate
• Contact support for higher limits

Next Steps

Stats API Documentation

Explore the full API capabilities

Dashboard

View your analytics dashboard