Designing Reports for PDF

For many readers, the PDF is the report. Board packs, investor and client reports, and scheduled sends all reach people as a PDF. Evidence includes components and options for developing reports that are effective both on the web and in PDF.

Export Your First PDF

Studio only — part of Evidence Studio, our hosted platform.

Open the page menu and choose Download PDF, or press Cmd+P / Ctrl+P on a published page.

The PDF Options dialog, with a preview on the left and the settings on the right

Setting	What it does	Default
Orientation	Portrait or landscape A4	Landscape when `page_width: full`; otherwise Portrait
Color scheme	Light or dark	Your current mode
Show cards	Prints content on cards, as on screen	The page’s `cards` setting
Use page colors	Prints your page background instead of white	Off
Margins (mm)	Space around each page	20 mm
Contents	Untick a heading to leave out that section; headings inside a repeat are listed once per value	All sections

Use landscape for wide tables and charts.

The same page exported in portrait and landscape

The same page with Show cards off and on

Light mode is usually best for printed PDFs.

Print Techniques

Keep Content on the Same Page

Wrap related content in print_group so it stays together — a heading with its chart, or a chart with its table.

{% print_group %}
	### Quarterly Revenue
	{% bar_chart data="quarterly_sales" x="quarter" y="sum(revenue) as 'Revenue'" /%}
{% /print_group %}

Use print_group hide=true to leave a block out of the PDF entirely.

Start a New Page

Add page_break where the next page should begin.

{% page_break /%}

## Details

Hide Filters and Controls

Wrap inputs in hidden_in_print. Otherwise they print as unusable controls.

{% hidden_in_print %}
	{% range_calendar id="date_range" title="Order date" /%}
{% /hidden_in_print %}

Add Content for PDF Readers

Use only_in_print for text that only PDF readers need.

{% only_in_print %}
	Prepared for the leadership team. All figures in USD.
{% /only_in_print %}

Adapt Filters for Print

Filters aren’t interactive in print, but they affect the content that’s included. Hiding filters and replacing them with a sentence describing the filter state can help a PDF remain clear.

{% hidden_in_print %}
	{% dropdown
		id="category"
		title="Category"
		data="products"
		value_column="category"
		multiple=true
		select_first=true
	/%}
{% /hidden_in_print %}

{% only_in_print %}
	Showing **{{category}}**.
{% /only_in_print %}

A multi-select prints as a comma-separated list. To show every filter value in one PDF instead of a single chart with an input, use a repeat. On screen, readers see the interactive dropdown and chart. In the PDF, they see one chart per value.

{% hidden_in_print %}
	{% dropdown id="department" title="Department" data="sales" value_column="department" /%}
	{% line_chart data="sales" x="month" y="sum(revenue) as 'Revenue'" filters=["department"] /%}
{% /hidden_in_print %}

{% only_in_print %}
	{% repeat id="dept" data="sales" column="department" %}
		{% line_chart data="sales" x="month" y="sum(revenue) as 'Revenue'" title="{{dept}}" filters=["dept"] /%}
	{% /repeat %}
{% /only_in_print %}

Add a heading inside the repeat to make each value its own section. The Contents picker lists every repeated heading, so readers can untick values they don’t need.

```sql weekly_orders
select * from (values
  ('Online',    '2026-01-06', 240),
  ('Online',    '2026-01-13', 285),
  ('Online',    '2026-01-20', 310),
  ('Retail',    '2026-01-06', 180),
  ('Retail',    '2026-01-13', 165),
  ('Retail',    '2026-01-20', 190),
  ('Wholesale', '2026-01-06', 420),
  ('Wholesale', '2026-01-13', 380),
  ('Wholesale', '2026-01-20', 450)
) as t(channel, week, orders)
```

{% hidden_in_print %}
	{% dropdown id="channel_picker" title="Channel" data="weekly_orders" value_column="channel" select_first=true /%}
	{% bar_chart data="weekly_orders" x="week" y="sum(orders) as 'Orders'" filters=["channel_picker"] /%}
{% /hidden_in_print %}

{% only_in_print %}
	{% repeat id="channel" data="weekly_orders" column="channel" %}

		## {{channel}}

		{% bar_chart data="weekly_orders" x="week" y="sum(orders) as 'Orders'" filters=["channel"] /%}

	{% /repeat %}
{% /only_in_print %}

The PDF Options Contents list showing Online, Retail, and Wholesale as separate sections

On screen, the dropdown controls a single chart. In print, each channel gets its own heading and chart. In the Contents picker, readers see “Online”, “Retail”, and “Wholesale” and can exclude any of them.

Tabs

Tabs print every tab in sequence, each with its title as a heading.

{% tabs %}
	{% tab title="Revenue" %}
		{% bar_chart data="orders" x="product" y="sum(amount) as 'Amount'" /%}
	{% /tab %}
	{% tab title="Orders" %}
		{% table data="orders" /%}
	{% /tab %}
{% /tabs %}

Print Components

Component	In the PDF
Page Break	Starts a new page
Print Group	Keeps contents together. `hide=true` leaves it out; `print_only=true` shows it only in print
Hidden in Print	Leaves contents out
Only in Print	Shows contents only in print
Repeat	Prints contents once per value of a column
Tabs	Prints every tab with its title as a heading

Get Started

Core Concepts

Features

MCP

CLI

Self Host

Direct Connectors

Evidence Warehouse

Components

Guides

Designing Reports for PDF

Export Your First PDF

Print Techniques

Keep Content on the Same Page

Start a New Page

Hide Filters and Controls

Add Content for PDF Readers

Adapt Filters for Print

Tabs

Print Components

​Export Your First PDF

​Print Techniques

​Keep Content on the Same Page

​Start a New Page

​Hide Filters and Controls

​Add Content for PDF Readers

​Adapt Filters for Print

​Expanding Dropdown Options into Sections in Print

​Tabs

​Print Components

Export Your First PDF

Print Techniques

Keep Content on the Same Page

Start a New Page

Hide Filters and Controls

Add Content for PDF Readers

Adapt Filters for Print

Expanding Dropdown Options into Sections in Print

Tabs

Print Components