HTML Publisher Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID htmlpublisher Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
1.9 (archives)
Nov 04, 2015
matrix-project (version:1.0)
workflow-step-api (version:1.4)
Source Code
Issue Tracking
Pull Requests
Open Issues
Pull Requests
Michael Rooney (id: mcrooney)
Usage Installations 2014-Nov 15426
2014-Dec 15505
2015-Jan 16038
2015-Feb 16409
2015-Mar 17302
2015-Apr 17491
2015-May 17466
2015-Jun 18184
2015-Jul 18785
2015-Aug 18844
2015-Sep 19208
2015-Oct 19346

This plugin publishes HTML reports.

Installation Steps:

1. Go to Jenkins Dashboard
2. Click on the link that says "Manage Jenkins"
3. On the Plugin Manager page, go to the "Available" tab next to Updates tab
4. Look for the html publisher plugin, select the checkbox and click install. Wait for it come back with status "Success".
5. Restart Jenkins by clicking the provided link on the success page, or if using tomcat, executing <tomcat-Jenkins>/bin/ and <tomcat-Jenkins>/bin/

How to use HTML Publisher Plugin:

HtmlPublisher plugin is useful to publish the html reports that your build generates to the job and build pages. Below are the steps to publish and archive the HTML report files

1. Click on the Configure option for your Jenkins job.

2. In the post build portion, look for the Publish HTML Reports option and select the checkbox. See the screen shot below

Fill the path to the directory containing the html reports in the "HTML directory to archive" field. Specify the pages to display (default index.html); you can specify multiple comma-separated pages and each will be a tab on the report page. Finally, give a name in the Report Title field, which will be used to provide a link to the report. By default, only the most recent HTML report will be saved, but if you'd like to be able to view HTML reports for each past build, select "Keep past HTML reports."

Some time at HTML directory, you don't have to specify project name, but have to start one level below. For e.g. if your project name is "ABC" and if HTML files are at "ABC/report-output/html" then you have to specify just \test-output\html\.

3. After saving the configuration, run build once. The published HTML reports are available to view from within Jenkins with convenient links in the dashboard.

Version History

Version 1.9 (November 4th, 2015)

  • added wrapperName field to maintain serialization compatibility. (JENKINS-31366)

Version 1.8 (October 18th, 2015)

Version 1.7 (October 16th, 2015)

  • Support FileSet includes (ant patterns) for report files (JENKINS-7139) (reverted in 1.8)

Version 1.6 (August 23rd, 2015)

Version 1.5 (July 26th, 2015)

  • Clean up / improve the configuration UI
  • Restore removed constructor in 1.4 to fix binary compatibility (JENKINS-29626)

Version 1.4 (May 24th, 2015)

  • Add an option to publish HTML reports even if the build fails. (JENKINS-11689, JENKINS-24057)

Version 1.3 (Nov 13th, 2013)

  • Add an option to allow a build not to fail if a report is not present
  • fix "html publisher plugin overrides report encoding with iso-8859-1" JENKINS-19268

Version 1.2 (Dec 10th, 2012)

  • revert "support Ant patterns in archive directory" to fix JENKINS-16083

Version 1.1 (Dec 7th, 2012)

  • support Ant patterns in archive directory (reverted in 1.2)
  • fix viewing HTML report for specific builds (12967@issue)
  • fix NPE (14491@issue)

Version 1.0 (May 10th, 2012)

  • Support environment variables when configuring the report directory and index pages (10273@issue)

Version 0.8 (Apr 26th, 2012)

  • Add empty descriptor to HtmlPublisherTarget (JENKINS-12258)
  • Scrollbar in HTML publisher due to 100% height on div/iframe (JENKINS-13070)
  • HTML Publisher does not work for multi-configuration projects (JENKINS-8832)

Version 0.7 (Aug 2nd, 2011)

  • Update to work with Jenkins 1.418+

Version 0.6 (Jan 20th, 2011)

  • Added Zip option to HTML Report View - this will provide a Zip file of the contents of the particular report (JENKINS-8163)

Version 0.5 (Jan 20th, 2011)

  • This version unintentionally left blank

Version 0.4 (May 24th, 2010)

  • The "Back to Jenkins" link is now "Back to JOBNAME" and goes back to the job instead of the Jenkins root (JENKINS-6521)

Version 0.3 (May 10th, 2010)

  • display per-build report links after a restart (only works for builds after the upgrade, alas) (JENKINS-5775)
  • don't display report links if there aren't reports yet (JENKINS-5683)
  • "Back to Jenkins" link triggers a back action in the browser if the user hasn't configured the Jenkins URL (JENKINS-6434)

Version 0.2.2 (Feb 17th, 2010)

  • Show all project-level reports on the project page, not just the first (JENKINS-5069)

Version 0.1.0

  • Initial release from abstraction of NCover plugin, allowing for archiving and displaying of HTML report directories


plugin-upload plugin-upload Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Add Comment