Updating your Github-managed theme in Guide



image avatar

Jennifer Rowe

Zendesk Documentation Team

Edited May 07, 2025


1

7

7 comments

Hi 1265163530689 ,


Don't know if this is still relevant to you, but aside from adhering to three-digit versioning convention as suggested by 1263082320149 ,  you need to bump up the version number in your theme manifest.json file before you fetch the updates from GitHub (for example, on the code below, it should be changed to 4.5.2). 

 

{
 

 "name": "Your theme name",
 "author": "Your theme author",
 "version": "4.5.1",
 "api_version": 1,

}




 

 

0


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. 

0


Hello 

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 ?

0


Ahmed Zaid

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

1


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.

0


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.

1


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?

0


Sign in to leave a comment.