"The page loads, but it's not all there."
That describes a significant portion of mysterious misbehaviors in web apps like CiviCRM, WordPress, Drupal, etc.
And problem reports like that tend to spike immediately after a software upgrade.
I've heard from 4 people today who experienced this class of problem, following yesterday's CiviCRM security update:
Some CiviCRM pages -- the main dashboard, or other admin-facing pages, appear completely empty.
Or they "mostly" display, but are missing some elements.
Or they'll even show a cryptic error message like "Unrecognized Angular module..."
In all these cases, the problem was caching.
What the heck is caching?
It's a mechanism to temporarily store code or data, so that pages load faster.
Your browser does it; your CRM does it; WordPress, Drupal, and other CMSs do it.
It's a great thing; it really does speed up the user experience.
And we almost never have to think about it.
But sometimes it needs a kick in the pants.
Usually, that "sometimes" is "right after an upgrade."
Here are two things you can do to knock it back into gear:
1. If you have admin access, the software itself usually offers a "clear caches" mechanism.
In CiviCRM, that's at Administer > System Settings > Clear Caches.
That will clear caches for all users across all CiviCRM pages.
2. You can also tell your browser to clear caches for any given page.
In Chrome (and Firefox, and many other browsers), just open the problem page, let it load, and then use Ctrl+Shift+R.
That will clear caches for that specific page, for that specific browser, for your computer.
Why this works:
If any of the cached components are out of date, that can create a conflict that leads to surprising misbehaviors on the page.
Clearing the cache resets all of that and causes the page to load the very latest versions of everything, so it's all in sync.
Does clearing caches make more problems?
Nope. It's safe to do any time.
The cache gets automatically rebuilt within a very short time.
Should I suspect caching as the cause of every oddity?
It never hurts to start there. For reference, see https://shouldiblamecaching.com/.
Then, if the above steps don't clear up the problem, you can begin looking deeper.
All the best,
A.

