What to do when encountering white screens

What to do when encountering white screens


Fixing white screens

White screens can occur for a number or reasons. This is a list of the most common- 
  1. "Glitch in the matrix"- Occasionally, in a web based environment, there are times where a data call goes wrong resulting in a white screen. 
  2. Although storing pages to the browsers cache makes loading pages faster, it can mean that changes made by TBN aren't always visible until you perform a hard refresh. When TBN pushes new functionality (about every two weeks) some browser settings can cause a white screen because they don't fully refresh and are using old code. 
  3. If your permissions have recently changed there can be conflicts created during login and use of the application that may result in a white screen. 
  4. Using an unsupported Browser- We reccomend users access TBN on Google Chrome.

Solutions when you encounter white screens- 

Hard refresh-

Performing a hard refresh is often the simplest way to fix a white screen issue. This is how to hard refresh your browser and clear your cache if you're using Chrome.

Chrome on Windows:

To hard refresh on Google Chrome on Windows, there are two ways you can do it:
  1. Hold down Ctrl and click the Reload button.
  2. Or Hold down Ctrl and press F5.

Chrome on Mac:

To do a hard refresh on Google Chrome on Mac, there are two ways that you can do it:
  1. Hold down Shift and click the Reload button.
  2. Or Hold down Command, Shift and click the ‘R’ key.

Advanced Cache Clearing Techniques

If white screen persist after a hard refresh, as outlined above. Please follow the steps outlined in the below video. 


Overview

This guide explains how to resolve the “white screen” issue that can occur when attempting to log in to OpsDriver. The root cause is typically related to browser caching, and this module walks users through clearing that cache and alternative login methods.

1. Use Google Chrome


First Recommendation:

  • Make sure you are using Google Chrome as your browser.

  • OpsDriver is QA-tested primarily in Chrome and performs best there.


If you’re using a different browser (e.g., Safari or Edge), switch to Chrome before continuing.

2. Clear Cache in Chrome


Step-by-Step Instructions:

  1. Open Chrome.

  2. Click the three dots in the top-right corner.

  3. Go to Settings.

  4. Navigate to Privacy and Security > Clear Browsing Data.

  5. Switch to the Advanced tab.

  6. Set the Time Range to All Time.

  7. Check only the following:

    • Cached images and files

    • Cookies and other site data

  8. Click Clear Data.


This clears old session data and should fix most white screen login issues.

3. Use Incognito Mode


If clearing your cache doesn’t work:

  1. Open Chrome.

  2. Click the three dots again.

  3. Select New Incognito Window.

  4. Navigate to the OpsDriver login page and sign in.


Incognito mode ignores previously stored cookies and cache, which often resolves display problems.

4. Try an Alternate Browser


If Chrome continues to give issues even in Incognito mode:

  • Use Mozilla Firefox.

    • Firefox has shown consistent success in situations where Chrome failed.

  • Avoid using Safari or Internet Explorer, which are not officially supported.

5. Hard Reload from Developer Tools (Advanced Option)


For tech-savvy users or with IT support assistance:

  1. On the login page, press F12 to open Developer Tools.

  2. Right-click or hover over the reload button in Chrome.

  3. Choose Empty Cache and Hard Reload.


This bypasses your browser’s stored settings and forces a clean page load.

Best Practices

  • Always use Chrome for the best experience with OpsDriver.

  • Bookmark the login page in Incognito Mode as a backup.

  • Clear cache regularly if using a shared or older machine.


Alert

If white screens persist after these steps, please contact support so they can help you get to the bottom of the issue and get it resolved.



    • Related Articles

    • Fixing White Screens at Login

      Fixing white screens at login SHORTCUTS To preform a hard refresh follow these steps. Windows users: hold down Ctrl and then press F5 on your keyboard. Mac users: hold down Cmd and Shift and then press R on your keyboard. Overview This guide explains ...

    • Document Types Explained

      Document Types TBN's Solutions are designed to give you options when communicating with customers. We know that often there are different needs for different customers that drive what data you want to show, how you present prices, and what level of ...

    • Management tools on the bookings screen

      Management tools on the bookings screen ? Training Module: Managing Bookings on the Bookings Dashboard ? Objective This module will teach users how to effectively manage and track bookings using the TBN Bookings Dashboard. By the end of this ...

    • CHEAT SHEET- It's time to start dispatching with OpsDriver

      Great News! Its time to start dispatching with OpsDriver- Here is a cheat sheet that will walk you through the important things you need to be aware of as you do. Dispatching with OpsDriver- Dispatching with OpsDriver gives you the visibility and ...

    • Update information in an existing booking

      Update information in an existing booking Overview This module explains how to update details in an existing booking in OpsDriver, including route times, vehicle types, and add-ons. Most adjustments are made in the Routes section, and changes are ...