Include issues list

You can include information on issues from a GitLab project by adding lists of issues in your Confluence page. For each issue you will get the title, type, priority, status, number of votes, assignee, created and last updated information.

Add the macro

You can pick the GitLab Issues macro from the macro browser. Alternatively you can type directly /GitLab Issues and ENTER to add and edit the macro.

You will then be prompted to specify the following:

Project path

path to the project

(e.g. https://gitlab.com/<orgname>/<projectname> or https://gitlab.mycompany.com/<orgname>/<projectname>)

Search query (optional)

Query used to filter and sort the list of issues. Check out the section below for more information on querying.

Example of adding a list of issues from GitLab

Query specific sets of issues

As mentioned above you can add a query option to the macro to display a specifically filtered and sorted list of issues.

The filtering syntax supported by the GitLab API is available in their documentation here: https://docs.gitlab.com/ee/api/issues.html

Examples:

List all closed issues	`state=closed`
List all open issues and sort them in descending order by their creation date.	`state=opened&order_by=created_at&sort=desc`

When adding search queries you can run the query and preview results simply by clicking out of the search query input field.