Basic Customization - CSS Changes
For simple customization needs, refer to our CSS customization guide:
Advanced Customization Options
The following customization options go beyond what our Support team can assist with. If you modify the integration's code, we cannot help troubleshoot any issues that arise.
Option 1: Modifying the Integration Template
This approach requires setting up a development environment and hosting your own version of the integration. Given the complexity of this approach, we recommend considering Option 2 instead, as it provides more flexibility with similar effort.
If you still want to proceed with this approach:
- Follow the setup guide: https://github.com/algolia/algoliasearch-zendesk/tree/master/app#modifying-templates
- Modify the template files:
- Template structure: https://github.com/algolia/algoliasearch-zendesk/blob/master/app/src/templates.js
- InstantSearch: https://github.com/algolia/algoliasearch-zendesk/blob/master/app/src/instantsearch.js
- AutoComplete: https://github.com/algolia/algoliasearch-zendesk/blob/master/app/src/autocomplete.js
Option 2: Building a Custom Search Page (Recommended)
For extensive customization needs, we recommend building your own search implementation:
- Build your search page using your preferred InstantSearch library
- Upload your custom code to Zendesk's theme assets:
- Create a custom page in your help center:
This approach allows you to maintain full control over your search experience while still using the integration's indexing capabilities.