USD Caching

Leave a comment

USD has caching functionality to allow the USD client to be loaded as quickly as possible. Caching can not only increase USD client startup time but also reduce bandwidth.

We will go through an example of how USD client caching works.

Firstly, client caching needs to be enabled in USD. Go to Settings->USD->Options:

If there is no ClientCacheVersionNumber key, create a new key. Enter ClientCacheVersionNumber as the name and option. Enter a numeric value for the Value. This will be incremented later. Save the record:

The cached data is stored in the \AppData\Roaming\Microsoft\USD folder. You can see here before caching is enabled, there are only a few files in this directory:

After saving, it creates these new files:

Now start the USD client. It will now start much faster than before as the setup looks at the local user cache.

Now let’s increment the ClientCacheVersionNumber on the server to 2:

The client will check the version locally vs the server and then retrieve the latest cache from the server, which will take extra time. On then starting another time again, it will retrieve the local cache quickly.

There is also the option to control how a specific user handles cache. Go to USD->User Settings:

Select a user, enter DisableCaching as the name and keep the Value as blank.

Starting USD will now get the server cache every time for this user instead of using the local cache.

Delete the DisableCaching record for this user and create a new record, ResetDesktopCache:

Rerunning the client, the cache in the AppData\Roaming\Microsoft\USD folder is rebuilt. You can also delete the cache data to reset it.


Carl de Souza is a developer and architect focusing on Microsoft Dynamics 365, Power BI, Azure, and AI.

carldesouza.comLinkedIn Twitter | YouTube


Leave a Reply

Your email address will not be published. Required fields are marked *