Git Integration for Jira Cloud Documentation

GitLab webhook indexing integration

More information:

Webhook indexing integration does not require indexing triggers in the git manager configuration page.

On this page:

Video Guides

Right click here to open in a new tab.

Right click here to open in a new tab.

Prerequisites: Install the Git Integration for Jira app on your Jira Cloud instance.

Go to Apps ➜ Git Integration: Manage integrations.
Click Add integration.
Select GitLab.com (or GitLab Server for self-hosted installations).
Select the Webhook indexing panel.

Webhook indexing has limited features but does not require firewall configuration.
Click Add integration. The webhook settings screen appears.
Do not click Finish yet. Copy the Webhook URL and Secret key, then configure webhooks in GitLab using the steps below.

Open your GitLab repository.
Go to Settings ➜ Webhooks.
Configure the webhook:

a. Paste the Webhook URL in the URL box.

b. Paste the Secret key in the Secret token box.
Select which events to trigger:

Event Recommendation

Push events RECOMMENDED Sends triggers for commits and branches

Tags push events Coming soon

Merge request events RECOMMENDED Sends triggers for merge requests
Click Add webhook to save.
Return to Jira and click Finish.

Event	Recommendation
Push events	RECOMMENDED Sends triggers for commits and branches
Tags push events	Coming soon
Merge request events	RECOMMENDED Sends triggers for merge requests

Open your GitLab group.
Go to Settings ➜ Webhooks.
Configure the webhook using the same settings as repository-level (see steps 3-4 above).
Click Add webhook to save.
Return to Jira and click Finish.

Group-level webhooks apply to all repositories within the group.
If webhooks fail, verify the Payload URL and Secret key settings.
Find Webhook URL and Secret key in Actions ➜ Edit integration.
IMPORTANT Repositories appear only after triggering push or merge request events.

To display commits in Jira, include the Jira issue key in your commit messages. See Linking git commits to Jira issues.

The Git Roll Up tab is supported for GitLab webhook indexing integration.

Feature	Status
Works behind firewall	Supported
View commits, branches, merge requests	Supported
View tags	Coming soon
Automation for Jira triggers	Supported
Smart Commits	Supported
Repository Browser	Supported
Create branches/MRs in Jira	Not supported
View source code	Not supported
Full repository history	Not supported

Automation triggers supported:

For complete feature details, see Feature matrix.

Last updated: December 2025

Have feedback about this article? Did we miss something? Let us know!