Reports & Exports
Clickport exports your analytics as a PDF report or as a ZIP of CSV files. Both follow the date range and the filters you have on, so you export exactly what's on screen.
Where to find the exports
Click Filter in the top bar and pick Export, the last row of the menu. It offers Export PDF and Export CSV. With filters on, the download icon after the pills opens the same two choices, with a reminder that the export uses the filters you have on. The command palette has both as well: press Cmd+K and choose Download PDF report or Download CSV export.
Filters and segments
Filter the dashboard before you export and the file holds only that slice: one country, one campaign, mobile visitors, the readers of one page. Values inside one filter are combined with OR, separate filters with AND. A segment saves a set of filters under a name, so a report you send every month starts from the same filters each time.
How to add, change, exclude and save filters is all on the Filters page.
PDF export
The PDF report is a multi-page landscape A4 document generated client-side using jsPDF and html2canvas. It includes your current KPIs, chart, top sources, top pages, geographic breakdown, and technology breakdown. Any active filters and the selected date range are reflected in the report.
Report layout
The PDF report contains up to three pages:
Page 1: KPIs and chart. The top shows the report header with the site name, date range label, and active filter badges. Below that, eight KPI cards display the key metrics with comparison percentages. The bottom half shows the time-series chart with all currently active metric lines.
Page 2: Traffic sources and top pages. Two side-by-side columns show horizontal bar charts. The left column lists your top 15 traffic sources with visitor counts. The right column shows your top 15 pages by visitor count.
Page 3: Geographic and technology breakdown. The left column shows your top 15 countries with flag emojis and visitor counts. The right column breaks down technology into three sections: Devices (top 3), Operating Systems (top 6), and Browsers (top 6).
KPI cards in the PDF
The eight KPI cards included in the report are:
- Visitors: Unique visitors in the period.
- Pageviews: Total page views.
- Conversions: Goal completions.
- Conv. Rate: Conversion rate as a percentage.
- Avg. Duration: Average session duration formatted as M:SS.
- Bounce Rate: Percentage of bounced sessions (inverted comparison arrow, so a decrease shows green).
- Views/Visit: Average pageviews per session.
- Avg. Scroll: Average maximum scroll depth.
Each card includes a comparison percentage against the previous period, matching the dashboard's weekday-aware comparison system. For details on how comparisons work, see the KPIs documentation.
Chart metrics in the PDF
The chart in the report reflects whichever metrics you have toggled on in the dashboard at the time of export. If you have Visitors and Pageviews enabled, the PDF chart will show both lines. Duration uses a dashed line on a secondary axis (seconds), while percentage metrics like Bounce Rate and Scroll use a 0-100% right axis.
How it works
When you click Export PDF, the dashboard first loads all panel data (even panels you have not opened yet). It then renders the three report pages as off-screen HTML, captures each page as a canvas using html2canvas, and assembles them into a landscape A4 PDF using jsPDF. The libraries are dynamically imported only when needed, keeping the main dashboard bundle small.
Pages 2 and 3 are conditionally included. If your filters result in no sources or pages data, page 2 is skipped. If there is no geographic or technology data, page 3 is skipped.
Filters in the PDF
Active filters appear as badges in the PDF header, just below the report title. The data in all tables (sources, pages, countries, technology) is also filtered to match your active dashboard filters.
Filename
The PDF file is named analytics-report-YYYY-MM-DD.pdf using the current date.
CSV export
The CSV export downloads a ZIP archive containing individual CSV files organized into subfolders. Like the PDF, it first loads all dashboard data, then generates the files client-side using JSZip (also dynamically imported).
ZIP structure
The archive is organized as follows:
Clickport export last 28 days.zip
├── traffic/
│ └── visitors.csv
├── pages/
│ ├── pages.csv
│ ├── entry_pages.csv
│ ├── exit_pages.csv
│ └── error_pages.csv
├── sources/
│ ├── sources.csv
│ ├── channels.csv
│ └── referrers.csv
├── geography/
│ ├── countries.csv
│ ├── regions.csv
│ └── cities.csv
├── technology/
│ ├── devices.csv
│ ├── browsers.csv
│ ├── operating_systems.csv
│ └── screens.csv
├── campaigns/
│ ├── campaigns.csv
│ ├── utm_sources.csv
│ ├── utm_mediums.csv
│ ├── utm_content.csv
│ └── utm_terms.csv
├── goals/
│ └── goals.csv
└── sessions/
└── sessions.csv
CSV file contents
Each CSV contains raw numeric values (no formatting). Here are the key files and their columns:
- visitors.csv: date, visitors, pageviews, bounce_rate, avg_duration_sec, avg_scroll_pct, clickers
- pages.csv: path, visitors, pageviews, bounce_rate, avg_duration_sec, avg_scroll_pct, clickers
- sources.csv: source, visitors, pageviews, bounce_rate, avg_duration_sec, avg_scroll_pct, clickers
- countries.csv: code, name, visitors
- sessions.csv: session_id, first_seen, duration_sec, pageviews, bounce, clicked, max_scroll_pct, entry_page
- goals.csv: goal, type, completions, visitors, conversion_rate_pct
Duration is always in seconds. Dates use ISO 8601 format (YYYY-MM-DD for daily, HH:00 for hourly). Session timestamps include the time component (YYYY-MM-DDTHH:MM:SS).
Security
CSV values are escaped to prevent formula injection in spreadsheet applications. Values beginning with =, +, -, or @ are quoted and prefixed with a single quote to prevent accidental execution when opened in Excel or Google Sheets.
Filename
The ZIP filename includes the date range for context: Clickport export last 28 days.zip, Clickport export today.zip, or Clickport export 2026-01-15 to 2026-02-12.zip.
Cross-filtering
Filters are not limited to the reports workflow. They are the core cross-filtering mechanism for the entire dashboard. When you apply a filter, every API query sent by the dashboard includes that filter parameter, so KPIs, the chart, and all panels update consistently.
Filters are persisted in the URL as query parameters (for example, ?filter_country=DE&filter_device=Mobile). Multi-value filters are pipe-delimited: ?filter_page=/blog/a|/blog/b for "Page is /blog/a or /blog/b". This means you can bookmark a filtered view, share it with team members, or paste a multi-value deep link into a Slack message and the recipient sees exactly the same scoped data.
You can also apply filters by clicking values in dashboard panels. For example, clicking "Google" in the Sources panel adds a Source is Google filter. Clicking another row in the same panel (say, "Bing") joins the same filter, which then reads Source is Google or Bing, instead of adding a second one. Every filter shows as a pill in the top bar, with an x to remove it.