---
title: "Jira Work Items macro"
canonical: "https://help.refined.com/space/MACROTOOLKIT/7414382594/Jira+Work+Items+macro"
format: markdown
---
Display a live list of Jira work items on your Confluence page, including inside Refined bodied macros like Tabs, Panels and Expandable Panels.   
  
*This macro is only available on **[Forge native versions of Macro Toolkit](https://refined.atlassian.net/wiki/spaces/MACROTOOLKIT/pages/6828064785)**.*

> Macro (rw-ui-tabs-macro)
> 
> > Macro (rw-tab)

## Before you start

The macro reads data from Jira, so Refined Macro Toolkit must also be installed on your Jira site.

1. A **Jira admin** installs Refined Macro Toolkit on the Jira site you want to pull work items from.
2. A **Confluence admin** approves the app update that adds the Jira read permission (`read:jira-work`).

## Adding a macro

1. Enter `/` OR click the `+` in the editing toolbar.
2. Search for and select the "**Refined Jira Work Items**" macro.
3. Set up the macro in the **edit modal** (see **Settings** below).
4. **Save** your changes.

## Editing a macro

1. While in page edit mode, **hover on** the Jira Work Items macro.
2. Click on the **macro title**.
3. Click on the **pencil icon** below the macro to open the **edit modal**.
4. **Edit the macro** to suit your preferences.
5. **Save** your changes.

## Settings

| Setting | Description |
| --- | --- |
| **Title** | Table heading. |
| **Filter** | Choose how to select work items.<br>- **Simple**: search for and select Jira projects.
- **Advanced (JQL)**: enter a Jira Query Language query to filter work items more precisely, for example by status, assignee or label. |