- 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 will be 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 is affecting just you, a few agents, or everyone on your team?
- If the issue impacts 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 can I troubleshoot issues with apps?
- The issue may be caused by how multiple applications are interacting with each other. This article has more on that approach: Avoid conflicts between applications.
- 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
You have arrived at step 5. We’re sorry none of the previous steps have helped resolve your performance issues. To help us get you back up and running as quickly as possible, collect the following 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 this article: Generating a traceroute for troubleshooting
- Consider granting Zendesk temporary access to your account so the agent can jump right into troubleshooting and check the configuration of your account.
- Most importantly, 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 so they don’t waste time replicating or asking you to run tests you’ve already done.