New to Telerik Reporting? Download free 30-day trial

Using the HTML5 Report Viewer in ASP.NET Core 3.1 Applications

This article guides you on how to add an HTML5 Report Viewer in an ASP.NET Core 3.1 web application.


The report viewer requires a reference to a running Reports Web Service. The report viewer can consume reports generated and served by any of the following Reports Web Service implementations:

  • A service that runs in another application.
  • A service that runs in a Telerik Report Server instance.
  • A service that is hosted locally in the same application.

In case you need to host it locally, follow the article How to Host Reports Service in ASP.NET Core 3.1.

Adding the HTML5 Report Viewer component using an item template

The HTML5 Report Viewer item template allows you to quickly and easily add the HTML5 Report Viewer to your application.

If you wish to connect the Report Viewer to a REST service, you can follow the steps outlined in the How to Use HTML5 Report Viewer with REST Service documentation article.

If you wish to connect the Report Viewer to a Report Server instance, refer to the article section Configuring the HTML5 Report Viewer to work with Report Server using Item Templates.

Adding the HTML5 Report Viewer component manually

  1. This tutorial uses the Barcodes Report.trdp report definitions file that must be located in a Reports folder inside the project. Follow the steps in the section Add Report Definitions to make the Barcodes Report.trdp file available in your project.
  2. Make sure that the app configuration inside the Configure method of the Startup.cs can serve static files:

  3. Add an HTML Page for the HTML5 Report Viewer by right-clicking on wwwroot and Add > New Item... > HTML Page. Name the file index.html and add the HTML5 Report Viewer's initialization. For a detailed explanation, check the HTML5 Report Viewer Manual Setup help article. The required references to jQuery and Telerik Kendo UI CSS and JS files are listed in the example below. By default, the necessary Report Viewer scripts and styles are served by the REST Service. The complete report viewer page should look like this:

    <!DOCTYPE html>
    <html xmlns="">
        <title>Telerik HTML5 Report Viewer Demo in ASP.NET Core</title>
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
        <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1" />
        <script src=""></script>>
        <link href="" rel="stylesheet" />
        <link href="" rel="stylesheet" />
        <script src="/api/reports/resources/js/telerikReportViewer"></script>>
            #reportViewer1 {
                position: absolute;
                left: 5px;
                right: 5px;
                top: 50px;
                bottom: 5px;
                overflow: hidden;
                font-family: Verdana, Arial;
        <div id="reportViewer1">
            $(document).ready(function () {
                        serviceUrl: "api/reports/",
                        reportSource: {
                            report: "Barcodes Report.trdp",
                            parameters: {}
                        viewMode: telerikReportViewer.ViewModes.INTERACTIVE,
                        scaleMode: telerikReportViewer.ScaleModes.SPECIFIC,
                        scale: 1.0,
                        enableAccessibility: false,
                        sendEmail: { enabled: true }
  4. Set the launchSettings.json launchUrl to the new HTML page.

  5. Finally, run the project to see the report.

See Also

In this article