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.3 (archives)
Nov 13, 2013
Source Code
Issue Tracking
Open Issues
Michael Rooney (id: mcrooney)
Usage Installations 2014-Mar 12934
2014-Apr 13109
2014-May 13251
2014-Jun 13473
2014-Jul 14100
2014-Aug 14300
2014-Sep 14974
2014-Oct 15372
2014-Nov 15426
2014-Dec 15505
2015-Jan 16038
2015-Feb 16409

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."

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.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
  • 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 (issue #12258)
  • Scrollbar in HTML publisher due to 100% height on div/iframe (issue #13070)
  • HTML Publisher does not work for multi-configuration projects (issue #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 (issue #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 (issue #6521)

Version 0.3 (May 10th, 2010)

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

Version 0.2.2 (Feb 17th, 2010)

  • Show all project-level reports on the project page, not just the first (issue #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