Skip to main content
Skip table of contents

Include pull (merge) requests list

You can include information on pull requests from a GitLab project by adding lists of pull requests in your Confluence page. For each pull request you will get the name, branch, author, id, last updated information and number of comments.


Add the macro

You can pick the GitLab Pull Request macro from the macro browser. Alternatively you can type directly /GitLab Pull Requests 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 pull requests. Check out the section below for more information on querying.

Include pull requests lists


Query specific sets of pull requests

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

The filtering syntax supported by the GitLab API is available in their documentation here: Merge requests API | GitLab

Examples:

List all closed pull requests for which the base branch was target-branch-name

target_branch=target-branch-name&state=closed

List all closed pull requests and sort them in descending order by their creation date.

state=closed&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.

Filter you pull requests lists

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.