At the time of writing this article, there isn't an automatic method to do in-place upgrade of an installed Zendesk Guide Theme to newer version. We have two methods -- manual, and updating via Github.
- Import new version of theme (zip) in your theming workbench
- Reconfigure it's setting same as you have done in earlier version (already installed)
- Upload assets once again
- Redo the customization if any.
We understand it might be a lot of work but we hope this should get simpler in future. Installing and configuring themes
It's being assumed that you know how to work with GIT repositories, and use Github to host your private repositories.
You can read following articles to understand Github integration with Zendesk Guide:
Once you have imported via Github, you can configure theme (only via settings panel).
To use Diziana themes as Github managed theme, you can extract content of theme zip file (that you download from our website), and copy contents of extracted archive directory (or contents of theming_center directory), commit changes in GIT, and push changes to Github. You can then Update Github-managed theme in guide to pull latest theme files from Github.
You shouldn't edit code of Github-managed themes in Zendesk Theme Code Editor. You will be warned when you click on Edit code button; if you ignore the warning and go ahead, the theme will be disconnected with your Github (i.e. you won't be able to update it from Github).
While updating a Github-managed theme, you will asked if you want to keep your settings or overwrite those with one in Github. Losing theme settings can be frustrating, hence we recommend you export theme settings & assets; and add those to your GIT repo:
- Export the theme to your local machine
- Extract the exported theme zip file
- Copy manifest.json and contents of assets directory from extracted theme directory to your local GIT repository
- Commit changes
- Push changes to your Github
If you follow above steps, it makes whole thing easier -- you can update theme code locally, and if required add more settings in manifest.json; you can now update Github-managed theme without any fear (because theme settings and assets in repository are in sync with one in Github-managed theme in Zendesk Guide).