Documentation for JIRA 4.2. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

When you create, edit or comment on a JIRA issue, some fields may display two small icons at the right of the text area: a blue screen (the 'Preview' icon) and a yellow question-mark (the 'Help' icon). The presence of these icons indicates that this field supports JIRA's Text Formatting Notation, allowing you to use rich-text features such as:

  • Italic, bold, underlined text.
  • Multiple levels of headings.
  • Bullets, numbered lists, tables and quotations.
  • Images.
  • Macros (see below).

For example, to include an image in the field, you would first attach the image to the issue, then type the following into the field:

To preview what the field will look like after you save it, click the 'Preview' icon:

Click the 'Help' icon to see a popup window containing the Text Formatting Notation Help.

Using Macros

The JIRA Text Formatting Notation and macros will only be available if your JIRA administrator has configured the relevant renderers.

JIRA ships with the following macros:



Enabled by default

Anchor Macro

Create an anchor that allows people to link to a specific point in a page. Usage:

... text here ...


Code Macro

Format blocks of source-code or XML. The default language is Java but you can specify JavaScript, ActionScript, XML, HTML and SQL too. Usage:

--- Java example ---
// Some comments here
public String getFoo()
    return foo;
*--- XML example ---*
  <another tag="attribute"/>


Quote Macro

Generate blockquotes that may contain multiple paragraphs or complex markup. Usage:

This is text from another source


No Format Macro

Create blocks of text where other wiki formatting is not applied. Usage:

This is text  \#&@!@(*!&*@()#*@\ \\
{macros} _wont_work_here


Panel Macro

Draw a panel with the following optional parameters:

  • title: Title of the panel
  • borderStyle: The style of the border this panel uses (solid, dashed and other valid CSS border styles)
  • borderColor: The color of the border this panel uses
  • borderWidth: The width of the border this panel uses
  • bgColor: The background color of this panel
  • titleBGColor: The background color of the title section of this panel
    {panel}Some text{panel}
    {panel:title=My Title}Some text with a title{panel}
    {panel:title=My Title| borderStyle=dashed| borderColor=#ccc| titleBGColor=#F7D6C1| bgColor=#FFFFCE}
    a block of text surrounded with a *panel*
    yet _another_ line


Colour Macro

Change the colour of the contained text. Usage:

look ma, red text!

You can use any of the sixteen standard HTML colours ('aqua','black','blue','fuschia','green','gray','lime', 'maroon','navy','olive','purple','red','silver','teal','white','yellow'), or any hexadecimal colour code (e.g. '#336699').


Lorem Ipsum Macro

Insert paragraphs of "lorem ipsum" space-filler text. Usage:



HTML Macro

Use HTML code within a Jira Issue. Usage:

<p>You'll find a lot more in <A href="chapter2.html">chapter two</a>.
See also this <a href="../images/forest.gif">map of the enchanted forest.</A></p>