GitHub / GitLab Integration
===========================

With the issue tracker integration, you can monitor GitHub / GitLab issues right
from within a Zammad ticket. This feature is optional. If you don't see it in
the ticket sidebar, that means your administrator hasn't enabled it yet.
Administrators can learn more in the
:admin-docs:`issue tracker integration in the admin documentation </system/integrations#integrations-for-issue-trackers>`.

.. figure:: /images/extras/issue-trackers/ticket-settings-with-github-issues.png
   :alt: Ticket detail view showing activated GitHub & GitLab function
   :align: center

   Use the |github| and |gitlab| tabs on the ticket sidebar
   for an overview of issues related to the ticket.

What Can It Do?
---------------

View related issues
   Use the |github| and |gitlab| tabs on the ticket sidebar to see linked issues,
   along with metadata like status (open/closed), assignee, labels, and more.
   Or, simply click the title to view the issue on GitHub / GitLab.
   A badge on the tab icon indicates how many issues are linked to this ticket.

Link a new issue
   At the top of the ticket sidebar, select *GitHub / GitLab > Link Issue*,
   then enter a valid issue URL. Please note that linking a new issue can be
   slow sometimes.

   .. figure:: /images/extras/issue-trackers/list-and-add-new-issues-to-ticket.gif
      :alt: Screencast showing how to list and add new issues to a ticket
      :width: 90%
      :align: center

Remove an issue
   Click the ✕ button next to an issue title to unlink it.

.. |github| image:: /images/icons/github-64px.png
   :alt: GitHub logo
   :width: 16px

.. |gitlab| image:: /images/icons/gitlab-64px.png
   :alt: GitLab logo
   :width: 16px