Why is my dashboard loading slowly?

Is your Admin dashboard taking longer than expected to load? Slow performance can be frustrating, but in most cases, it can be resolved quickly by checking a few common factors. This guide walks you through the most likely causes and step-by-step solutions.

Common Causes

Before diving into fixes, it helps to understand what might be slowing things down:

• Large Datasets: Widgets querying millions of rows take more time to aggregate.
• Browser Cache: Corrupted or outdated cached files can cause rendering delays.
• Conflicting Extensions: Ad blockers or script managers may interfere with Admin's JavaScript.
• Network Latency: Unstable internet connections or firewalls can delay requests.
• Custom Scripts: Injected third-party code may block the main thread.

Step-by-Step Troubleshooting

Follow these steps in order. Most users resolve the issue within the first three steps.

1. Hard Refresh Your Browser

   Clear the temporary cache for the current page by pressing Ctrl + F5 (Windows/Linux) or Cmd + Shift + R (Mac). This forces the browser to download the latest assets from our servers.

2. Test in Incognito Mode

   Open an Incognito or Private window and log in. If the dashboard loads quickly, a browser extension is likely causing the conflict. Disable extensions one by one in your normal window to identify the culprit.

   ⚠️

   Note: Known problematic extensions include certain ad blockers, dark mode enforcers, and aggressive script blockers. Consider adding app.admin.io to their allowlists.
3. Check Widget Data Volume

   If your dashboard contains many widgets displaying real-time data, it may take time to fetch. Try removing non-essential widgets or applying date filters to reduce the query load.

   💡

   Pro Tip: Use the "Auto-refresh" toggle to disable background polling for static reports. This can significantly reduce network traffic.
4. Verify Network Connection

   Run a speed test to ensure your connection is stable. Admin requires a minimum of 5 Mbps for optimal performance. If you're on a corporate network, check with your IT department for any firewall rules blocking WebSocket connections.

Advanced Diagnostics

If the basic steps didn't work, use your browser's developer tools to inspect the issue.

Checking the Console for Errors

1. Open Developer Tools (F12 or Right-click → Inspect).
2. Navigate to the Console tab.
3. Reload the dashboard.
4. Look for any red error messages.

   Example error:
   Uncaught TypeError: Cannot read properties of undefined (reading 'fetch')
       at WidgetManager.js:142
       at async DashboardRenderer.init (Dashboard.js:89)

   If you see errors like the above, take a screenshot and contact support. This often indicates a specific configuration conflict.

   Network Tab Analysis

   Switch to the Network tab and reload. Look for requests that are hanging or timing out. The api/admin/v2/data endpoint is critical; if this request fails or takes >3000ms, it may indicate a backend issue on our side or a gateway timeout.

   🔧

   Custom CSS/JS Users: If you've injected custom code, ensure it's wrapped in a window.onload or uses defer. Blocking scripts will pause dashboard rendering.

   Still Having Issues?

   If you've tried all the steps above and your dashboard remains slow, please reach out to our support team. To help us diagnose faster, include:

   • Your browser name and version.
   • A screenshot of the Console and Network tabs.
   • The specific dashboard ID (found in the URL).
   • Approximate time when the issue started.

   Contact Support →

   Was this article helpful?

   👍 Yes 👎 No

   Thanks for your feedback!

   Related Articles

   How to optimize dashboard performance Browser compatibility requirements Managing custom scripts safely Understanding API rate limits