Updating your Github-managed theme in Guide

Return to top


  • Miguel Romero

    I found this "Important: If you set up an integration with GitHub, making any modifications to your theme in Guide will break the GitHub integration." on https://support.zendesk.com/hc/en-us/articles/4408838187802-Working-on-a-theme-locally


    How can I reverse the lost link with github?

  • David Bjorgen

    Miguel Romero, once you've broken the link with GitHub, there is no way to restore it. Instead, you must pull another instance of your theme from GitHub and make it the live theme.

    On the occasion that I need to break the GitHub integration in order to do some live testing, here is my process:

    1. Click on the menu icon of the live theme and choose "Copy," which saves a GitHub-connected copy (complete with intact theme settings) in the theme library.
    2. Break the GitHub integration in the live theme and work on testing.
    3. Once live testing is complete, update changes in source code and push to GitHub.
    4. Back in Zendesk, go to the Theme Library and set the copy of your theme as the live theme. The disconnected copy will move to the Theme Library.
    5. Update the live theme with the latest from Github.
    6. Delete the disconnected copy in the Theme Library.
  • Miguel Romero

    Thanks a lot, @David Bjorgen. I followed your process and it worked for me. I have to be very careful in the future when I edit. I appreciate your comments.

  • Ahmed Zaid
    User Group Leader Community Moderator
    Zendesk Luminary


    Is there a way to automate this action?

  • Gorka Cardona-Lauridsen
    Zendesk Product Manager

    Ahmed Zaid

    You can automate theme updates using GitHub actions and our Themes API.

  • Responsable-produit


    When i try to update my file with github I have this message  : 

    The version number of the imported theme is not allowed. Please contact the theme developer to verify that the version is compliant with the Semantic Versioning 2.0.0 standard and higher than the current version.

    Somebody ever had the same problem ? what can i do ?

  • Sabra
    Zendesk Customer Care

    Hey Responsable-produit! That error indicate's the theme's version number in the manifest.json file does not comply with the versioning convention. This will need to be updated following convention. 


Please sign in to leave a comment.

Powered by Zendesk