Editing a theme's code

Editing theme code is where a help centre becomes yours to maintain. Three habits keep that manageable.

Editing theme code is where a help centre becomes yours to maintain. Three habits keep that manageable.

Edit it

1. In Knowledge, click Customize design in the sidebar.
2. Duplicate the theme you are starting from. Zendesk says the same thing: to change your live theme, duplicate it and edit the copy.
3. Click Customize on the duplicate, then Edit code.
4. Make the change and save it. You cannot preview until you have saved.
5. Preview, then make that theme the live one when you are satisfied.

Habit one: always work on a copy

The published theme is what readers see, live, with every save. Duplicating first means you can preview freely and switch when ready, and reverting is switching back rather than undoing.

Habit two: export before and after

Exporting gives you a file. That is your backup and your version history, because the editor has neither.

A theme customised over two years with no exports is one bad afternoon away from being unrecoverable.

Habit three: write down what you changed

Somewhere outside Zendesk. Which files, what for, and why. That is what makes it possible to apply a Zendesk update to your fork later, and it is what the next person needs.

The templates

Home page, category, section, article, search results, request form. A change to one does not affect the others, and forgetting that is the usual reason an edit seems not to work.

Check on a phone

Every time. Custom code is where responsive layouts break, and the help centre is read on phones as much as on desktops.

See also

• Importing and exporting a theme
• My theme change is not showing
• Templating: which parts you can change