Macro configuration

After a STAGIL macro is added to the page, it is empty by default and will not be displayed in the page view until configured.

To start configuring the macro, go to page edit mode → hover over and click on the macro to see the macro edit toolbar. Select Edit (pencil icon) to open the macro content parameters configuration dialogue.

Open

Click the ‘Edit’ button to open the ‘Edit macro’ dialogue.

When first added to the page, the macro will be empty, with no issues displayed.

Macro scopes

Users can create a custom data table that displays Jira issues or Confluence tasks. The first step is to set up the data the user wants to display by defining a scope—an exact list of tasks or issues conditioned by filters or managed manually.

Before configuring a scope, select a Jira instance to display issues from in the ‘Jira connection’ field.

To add a new scope, click on the ‘Add scope’ link button in the macro configuration:

Macros can contain multiple tables with different scopes. Each new scope table will be displayed in a separate tab.

Open

Scope: JQL filter

This scope allows the display of a list of JQL query results.

To configure, select the JQL filter in the ‘Scope type’ selector and enter a query in a ‘JQL’ field:

Scope: manual issue selection

Manual scope also allows to return issues from a JQL query. However, the JQL query is not pre-configured in the same way as for the JQL scope. Instead, users can add issues that have been returned by multiple JQL queries. New JQL queries are added from ‘Edit macro’ dialogue:

To remove a single issue from the table, hover over the right end of the issue table to reveal a three-dot icon. Click the button to open the ‘Actions’ menu with an option to remove the issue from the table. Issues can be removed by users directly from the page view in the ‘Edit macro’ dialogue.

Scope: Confluence tasks

This scope allows us to get a list of Confluence tasks in the instance. The tasks table is displayed with 4 default columns: Description, Assignee, Due Date and Page (parent page of the task).

Tasks can be filtered by location, status, assignees, and due date.

Table columns

In the issue table, columns represent the issue fields. A wide range of system and custom fields is available to add, view and edit via our macro. See for the list of supported fields.

To add a column, select a custom field in the ‘Jira issue columns to display’ drop-down list. The added field will be immediately available in the preview:

Columns can also be added or removed from the table directly from the page view. Click on the filter icon in top right corner of the macro to open the column configuration menu:

Table pagination

In the ‘Rows per page’ configuration field, users can determine the number of issues or tasks that will appear on the screen before pagination is activated.