Features Tips & Tricks

Integrate YouTrack With GitHub!

Great news for all GitHub and YouTrack users. Today, we are introducing native integration between YouTrack and GitHub.
What will you get? You can type any command (just as with command window) right in the commit comment, and this command will be applied to the issue associated with commit. For example, should you commit files with a comment like #JT-1787 fixed tag to be documented, issue JT-1787 will be fixed and tagged as “to be documented”.
Interested? In order to integrate your YouTrack installation or hosted instance with GitHub repository, you’ll need to navigate to Admin->Service Hooks part of your repository and find YouTrack at the bottom of the list of available service hooks. You’ll also find all necessary instructions in service hook description.
Note: if you’re using YouTrack 2.x version, the command specified in commit comment will be applied with the administrator credentials, if you’re using YouTrack hosted, and generally starting from the next YouTrack version, the command will be applied with the committer’s credentials.

Integrate and track with pleasure!
JetBrains YouTrack Team

Comments below can no longer be edited.

13 Responses to Integrate YouTrack With GitHub!

  1. Avatar

    Chris Jackson says:

    August 29, 2011

    Any advice on how to troubleshoot this?

    Pushing a commit to GitHub with the message “#admin-16 fixed” doesn’t seem to do anything. My email address is the same in YouTrack and GitHub’s user settings. Also, in the YouTrack service hook on GitHub, if I click “Test Hook” I get the message “Payload deployed”.

    • Avatar

      Johan says:

      August 20, 2014

      Did you come up with a solution? I have the same problem

    • Avatar

      Tyler DeWitt says:

      December 2, 2014

      Use the ^ character instead of #. Git appears to ignore lines starting with a # now.

  2. Avatar

    Jovo says:

    October 4, 2012


    we defined a custom state for our issues. Is there a way to set this state through a GitHub commit message via service hooks?



    Note: The state contains whitespace characters.

    • Avatar

      Anna says:

      October 4, 2012

      Hello, Jovo!
      Yes, it should be possible. Message should be something like:
      State my own state

  3. Avatar

    Steve Sheldon says:

    November 9, 2012

    Hey Guys, I have a workflow question…

    Let’s say in Github I work on a feature branch called “Feature” and we had a main branch called “V 1.0”. Our build for the test team will be built from the “V 1.0” branch. Now let’s say I do a commit and push for a bug fix into the “Feature” branch.

    It will now go up on github for code review but it isn’t in the branch used for test builds yet, so if the bug is marked fixed it’s premature.

    Once the code review has passed, the change will be merged into the “V 1.0” branch. At this point we want the you track bug to be marked as fixed.

    What I am getting at is if there is a way to have put the commands for youtrack in the commit on the feature branch and specify a way to say, only run them when committed to the “V1.0” branch. I am looking to have a way to have some accountability for each bug and control the timing of the updates without losing all the benefits of Git.

    Thanks, Steve

    • Avatar

      Steve Sheldon says:

      November 9, 2012

      Looking on Github it looks like this isn’t supported for YouTrack but is by BugZilla, is there any chance you can add an option for the integration branch(es) to watch?

      • Avatar

        Anna Zhdan says:

        November 12, 2012

        Currently there is no such feature in GitHub integration. You can vote for this issue: http://youtrack.jetbrains.com/issue/JT-17040

        • Avatar

          Dave Konopka says:

          November 29, 2012

          A branch setting has been added to the Github service hook. You can limit commands to a single branch now. Or leave it blank to take commands from all branch commits.

          • Avatar

            Anna Zhdan says:

            December 6, 2012

            Hello, Dave!
            Thank you very much for contributing!

  4. Avatar

    Vasundhar says:

    October 16, 2014

    We are unable to use github hook,
    We did what ever is documented , for some time it seems to have worked.
    Then #Issue-102 Fixed has no effect . Its Broken Need to be fixed.
    I sent mails to the support, being a paid customer at least I could get a response which is NULL.

    • Avatar

      Anna Zhdan says:

      October 16, 2014

      Hello! Could you please email to youtrack-feedback@jetbrains.com your installation parameters: whether you have InCloud of self-hosted YouTrack?
      Also, if it’s InCloud I’ll need your instance name, and if it’s self-hosted, could you please attach logs?

  5. Avatar

    YJ says:

    October 24, 2014

    For complete youtrack commands working with GitHub comments, please see http://confluence.jetbrains.com/display/YTD5/Command+Grammar . Beware you do not write comments after the issue ID.

Discover more