Dashboards: Introduction

TestRail allows you to integrate reporting dashboards in third-party applications like Confluence, wiki tools, intranets and project management applications. To integrate the dashboards, TestRail provides special pages that can be used in iframes. The pages render without any TestRail navigation menus so it's easy to natively integrate the pages in other applications.

If you are interested in integrating TestRail's dashboards with Confluence, please also see our separate Confluence integration page.

Please note: If you are using HTTPS for your host application (e.g. Confluence, Sharepoint or similar), TestRail also needs to use HTTPS and the referenced URLs need to start with https://. Otherwise browsers will not load the referenced frames.

Available dashboards

TestRail provides two main dashboards that can be integrated in third-party applications. Each dashboard link can also be customized with various parameters (please see below).

Main dashboard

The main dashboard shows an overview of available projects, the activity chart as well as options to expand projects to review related milestones. Clicking on a project loads the relevant project dashboard. Example address:

https://example.testrail.com/index.php?/ext/common/dashboard

Project dashboard

The project dashboard provides a snapshot and all relevant details for a specific project, including related test runs, milestones, recent reports and project activity. Example address:

https://example.testrail.com/index.php?/ext/common/projects/1

Parameter reference

The dashboard integration pages support various optional parameters to customize the style of the pages. For example, to include a border around the integration page with additional padding, the integration link could look like this.

https://example.testrail.com/index.php?/ext/common/dashboard&
border_style=solid&border_color=c0c0c0&border=1&padding=15&margin=20

Please see below for a full reference of supported parameters for the different integration pages.

Parameter Example Description
padding padding=10 The padding TestRail should add to the main container element.
margin margin=10 The margin TestRail should add to the main container element.
border border=10 The border width TestRail should use for the main container element.
border_radius border_radius=10 The border radius TestRail should use for the main container element.
border_color border_color=c0c0c0 The border color TestRail should use for the main container element.
border_style border_style=solid The border style TestRail should use for the main container element.