Customise word export template for JIRA applications

Still need help?

The Atlassian Community is here for you.

Ask the community


This KB article outlines how to customise the output from JIRA applications while exporting issues to Word documents.


The content on this page relates to platforms which are not supported. Consequently, Atlassian Support cannot guarantee providing any support for it. Please be aware that this material is provided for your information only and using it is done so at your own risk.

  1. The output of word export is controlled by the four velocity templates located at atlassian-jira/WEB-INF/classes/templates/plugins/issueviews located under JIRA applications Installation Directory. 
    1. single-word-css.vm - Defines the html styles used for export
    2. single-word-header.vm - Defines the header part of the exported document
    3. single-word.vm - The content part of the exported document
    4. single-word-footer.vm - The footer part of the exported document
  2. Open these files in your favorite text editor and make the required changes and save it.
  3. Restart the application.

There is a New Feature for this functionality to be handled within the core of JIRA applications, as tracked at:  JRA-12813 - Getting issue details... STATUS  Please vote and watch that issue if you're interested in the functionality.

Example: Changing Word Export to A4 size

  1. Access single-word-css.vm.
  2. Open in a text editor and Add the following css under <style type="text/css">:

    /The A4 paper size is 210 mm wide by 297 mm long/
    size: 210mm 297mm!important;

  3. Save and restart your JIRA application.

tip/resting Created with Sketch.

This article is valid only for Server version of JIRA, if you have a Cloud installation you won't be able to follow these instructions

Last modified on Jul 20, 2021

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.