Stand with Ukraine flag
Pricing Try it now
Cloud
North America
Documentation > Reporting > Scheduling reports
Getting Started
Devices Library Guides API FAQ
On this page

Scheduling reports

Available since TB Version 4.2
Doc info icon
ThingsBoard PE Feature

Only Professional Edition supports Scheduling feature.
Use ThingsBoard Cloud or install your own platform instance.

The Scheduler is a mechanism for automating report generation. It allows you to set up automatic creation and distribution of reports at a specified time — based on a pre-defined report template.

With the Scheduler, you can:

  • Receive reports regularly without manual execution — no need to trigger them yourself.
  • Set custom intervals — daily, weekly, monthly, or any custom schedule.
  • Define recipients and formats — choose who gets the report and in what format (PDF, CSV).
  • Use one template for multiple recipients with different data filters — tailor the same report for different audiences.

Creating a new scheduler event

  • Open the “Reporting” page from the left-hand sidebar and go to the “Scheduling” tab.
  • Click the “+ Scheduled report” button in the top-right corner.
  • In the scheduling dialog:
    • Specify the schedule name.
    • General configuration:
      • Event type – always “Generate Report”.
      • Report template – select a predefined report template to use.
      • User – select the user whose credentials will be used for report generation.
      • Time zone – choose the time zone for report generation.
      • Recipients:
        • Recipients — specify the users who will receive the report.
        • Template — select the template that defines the report delivery method.
    • Schedule settings:
      • Start time – set the initial trigger time.
      • Time zone – select the time zone in which the schedule will operate.
      • Repeat – toggle to enable recurrence: choose intervals like daily, weekly, or monthly.

You'll find all generated reports under the “Reports” tab.

Reports

The “Reports” tab stores all your generated reports. Here you can:

  • Download reports.
  • Filter reports by report template or by the user whose credentials were used to generate the report.
  • Delete unnecessary reports.

The number of generated reports can be limited per tenant via tenant profile configuration.