Setting up the GitHub integration with your Guide theme

Return to top


  • Artem Fursenko

    Is there a possibility to have other Git repo integration e.g. Bitbucket, GitLab - not GitHub?

  • Ekaterina Sumolaynina
    Zendesk Customer Care

    Artem Fursenko Unfortunately, at this moment we don't have any official integrations with Bitbucket or Gitlab.There might be 3rd party integrations available (via Zapier, for example), but I won't be able to provide detailed information about it. I'd recommend following up our announcement page in case if there are any news regarding this:

  • Andrew Mantle

    Hi. Do you have to use Zendesk to preview the output or is there a way of locally checking the changes?



  • Gorka Cardona-Lauridsen
    Zendesk Product Manager

    Hi Andrew Mantle

    You can work with theme locally using Zendesk app tools (ZAT).

    Check out:

  • Tim Dilger


    Can you keep help center articles in code in a repo and sync them to Zendesk on a git push?


  • Dane
    Zendesk Engineering
    Hi Tim,
    As it turns out, the option for git push is not supported. I also took the liberty of checking our Marketplace for similar integration but there's none. The only available option when it comes to creating articles if you have your own repository is through Help Center API.
  • Brandon Castillo

    Hi Zendesk, 

    Is it possible to add a private repo to the GH integration? If not, are there any updates on future integrations like BitBucket? I couldn't find any help articles related to those topics. Thank you.

  • Greg Katechis
    Zendesk Developer Advocacy
    Hi Brandon! Private repos are absolutely fine, as long as the person who is setting up the integration has access to that repo. If you run into any issues while setting this up, take a look at our troubleshooting guide. Regarding BitBucket, we do not have any integrations set up with them at this time.
  • Simon
    Hi there,
    The article mentions that the Github integration does not support Github Enterprise? Does this include Github Enterprise Cloud?
    Do you have any advice on how to manage change conflicts with the core theme files when trying to merge updates? Has the theme been designed in a way that helps avoid merge conflicts? 
  • Clifford James Lacson
    Hello Simon,
    Thanks for reaching out to us! My name is Clifford from the Advocacy department and I'll be the one assisting you with your concern. :) 
    In regard to your concern with Github Enterprise Cloud, I have reached out internally to our Github team so I will be providing you an update once I confirmed with them.
    For the 2nd one, may you please elaborate on managing change conflicts? Can you provide a use case for this?
    I look forward to your response!
  • Simon

    Hi @... ,

    In regards to managing change conflicts, we plan to copy the Zendesk Copenhagen theme repo rather than fork it, that way we can create our own forks privately. From there, we can pull updates from the main repo and marge them with our private fork. Github helps manage change conflict but we wanted to know how Zendesk might help prevent conflicts when updating the theme files?

  • Nara
    Hi Simon - at this time, Zendesk does not provides any specific change conflict management for the individual use of ZD Guide themes. It is ultimately up to individual users to ensure that when making a copy of the theme repo, that updates pulled from main merge into the their copied environment.
  • Adeem Basraa

    Is there a possibility to sync with GitLab instead of GitHub? I know it snot possible currently but is the integration with gitlab in the roadmap?

  • Gorka Cardona-Lauridsen
    Zendesk Product Manager

    Adeem Basraa A Gitlab integration is not on the roadmap currently, but you could set up your own integration using the Themes API.


Please sign in to leave a comment.

Powered by Zendesk