- Step One
- Step Two
- Step Three
- Step Four
- Step Five
Step One: Check for a service incident
Check the Zendesk status page to find if this issue is more widespread
If you experience performance issues, check the Zendesk status page: status.zendesk.com.
If there are any active service disruptions or incidents, they are listed on that page and you can monitor the status as the progress of the incident. For more information on how to read the status page, see the article: Monitoring your account status on the System Status page.
Step Two: Basic troubleshooting
Try these potential quick fix steps
There are some quick initial steps you can take to improve your system's performance right away.
- Make sure your browser and system are up to date and match our Zendesk Support system requirements.
- Clear the cache and cookies on your browser as described in this article: Options to clear cache and cookies.
- Restart your computer, restart your browser, and close out any background programs or extra tabs and windows. These steps help clear out any errors or issues happening in the background and free up processing power to help your system run more smoothly.
Step Three: Narrow down the scope of the issue
Test and answer scoping questions to find the cause
After attempting some basic troubleshooting steps, it is important to understand the scope of the issue. Consider these questions before you proceed:
- Is the issue affecting just you, a few agents, or everyone on your team?
- Is the issue impacting multiple agents are all agents working in the same location? Are all agents on the same network?
- How long has this issue been occurring? When did the issue start?
- Is this the first time this issue has happened? If it occurred previously, when did it occur and how frequently?
- Does switching to an incognito or private browsing mode help resolve the issue?
Step Four: Check your hardware, software, and network
Use these tools to troubleshoot further
This section is helpful for instances where the problem is either affecting multiple users on your Zendesk account, or it is only affecting one user and the previous steps did not resolve the issue.
- Disable any browser extensions you have and test again.
- If possible, connect to a mobile hotspot or another network to check if it is a network issue. See more network troubleshooting in this article: Why is Zendesk slow and laggy when I work from home?
- An app on your Zendesk account may be causing the issue. For information on how to troubleshoot that possibility, see this article: How ca n I troubleshoot issues with apps?
- If the issue is affecting only users on the same network, reach out to your IT team or Internet Service Provider.
If you still are unable to find a resolution, generate a HAR file and share it with your IT team or another team member who has experience with how to interpret these files. For more information, see this article: Generating a HAR file for troubleshooting.
Step Five: When all else fails
Collect the following information and contact Zendesk Customer Support
To help us get you back up and running as quickly as possible, collect the below information to send along with your support ticket:
- Visit supportdetails.com from the computer and browser that you use to access your Zendesk account. Take a screenshot of that information and include it in your support request so the agent is able to tailor their troubleshooting to your specific situation.
- Run a traceroute as described in these articles:
- Guide from Microsoft's Help Center: How to Use TRACERT to Troubleshoot TCP/IP Problems in Windows
- Guide from the external website Hostgator: How Do I Run a Traceroute on a Mac?
- Guide from Microsoft's Help Center: How to Use TRACERT to Troubleshoot TCP/IP Problems in Windows
- Consider granting Zendesk temporary access to your account so the agent can jump right into troubleshooting and check the configuration of your account.
- When you contact Zendesk Customer Support, provide detailed information on the following:
- Describe the issue in detail and what you expect should happen if the system were working correctly.
- Let the agent know the information you gathered in step 3: Who is affected, when did it start, and so on.
- Let the agent know what troubleshooting you’ve done already.
9 Comments
Hello, Ben. Could you please explain how you made the accordions and progress bar in this article?
Hey Yalon,
This was done through custom code and I was able to track down a user tip that may point you in the right direction: Help Center - Collapsible headers in articles (accordions)
As for the progress bar, I wasn't able to find any information on how to set this up so you may want to get your developers involved to assist further.
Cheers!
Thanks, Brett I've managed to implement the accordions part, as for the progress bar - I've found this: https://support.zendesk.com/hc/en-us/community/posts/1260802608910-How-to-implement-our-troubleshooting-guide.
Your traceroute link is now dead, just a heads up.
Thanks for the head's up, CJ. This should now be fixed.
Hey, just letting you know -- it still isn't working. https://support.zendesk.com/hc/en-us/articles/1-Generating-a-traceroute-for is a dead link.
We've updated the above doc, and replaced that old internal link with a couple of links with more specific processes for Macs and Windows machines.
For the traceroute, what address do we test to? I'm assuming https://{your_zendesk_domain}.zendesk.com
https://support.zendesk.com/hc/en-us/articles/4416585561882-How-can-I-generate-a-traceroute-for-troubleshooting-
Please sign in to leave a comment.