Subscribe to a report

Subscriptions let you schedule the automatic delivery of a Data Query report on a recurring basis — for example, sending a daily traffic CSV to your team's FTP server, or pushing a weekly performance file to a downstream system.

Before you start

A few things to know before creating a subscription:

  • The report must be saved. Subscriptions can only be created from saved reports — not from unsaved working drafts.

  • Subscriptions are managed from the Library, not from inside the report itself.

  • CSV subscriptions are for Data Query reports. Email subscriptions also exist, but they're for boards, not reports. (See Subscribe to a board for that flow.)

  • The subscription is tied to the report. If you later modify the report — adding a property, changing a filter, etc. — the subscription will reflect those changes from then on. Each delivery always uses the current saved version of the report.

Create a subscription

  1. Open the Library and locate the saved report you want to schedule.

  2. Click the + button in the bottom-right corner of the Library and select Subscription.

  3. In the New subscription panel, configure the following sections:

image-20260602-133918.png

Subscription settings

  • Subscription type — Select CSV for Data Query reports (Email subscriptions are reserved for boards).

  • Subscription name — A short, recognizable name. This will appear in the Library and in delivery filenames.

  • Description (optional) — Up to 1,000 characters to describe what this subscription covers.

  • Frequency — How often the report should be delivered. Daily, Weekly, or Monthly (the Hourly granularity is reserved for organizations with the Data Flow option).

  • Site(s) — The site(s) the report should run against.

  • Enable comparison — Toggle on to include period-over-period comparison data in the delivery.

Source

  • Report — Select the saved report to schedule. Only reports already saved in your Library appear here.

Delivery

  • Destination — Choose where the file should be delivered (FTP or Amazon S3).

  • Settings — Select an existing FTP configuration, or add a new one. An FTP connection must be configured before the subscription can be saved.

  • File prefix — The prefix used for delivered filenames. Defaults to export_<timestamp>; you can customize it.

CSV options

  • Field separator — The character used to separate fields (e.g., Comma, Semicolon, Tabulation, etc.).

  • More options — Toggle on to reveal additional CSV settings:

    • Field encapsulation — How field values are wrapped (e.g., Double quote).

    • Headers — How column headers are formatted (e.g., Classic names like Converted visitors).

    • Null value replacement — How missing values should be represented (e.g., Empty).

  1. Click Save.

The subscription is now active and will run automatically at the chosen frequency.

Manage subscriptions

image-20260602-134725.png

All subscriptions are listed in the Library under their own resource type. From there, you can:

  • Open a subscription to review or edit its configuration.

  • Pause or resume delivery.

  • Delete a subscription you no longer need.

Limits

A single subscription delivery can contain up to 200,000 lines.

Need more? A premium option is available for higher volumes. Contact our support center for details.