Specifies the cache duration (in minutes) for the list of your Bitwarden items.

This setting configures the on-demand refresh mechanism. It is not a background timer that runs at a fixed interval.

Instead, when credentials are requested (e.g., by a pipeline or by opening the Credentials UI), the plugin checks the age of its cached item list. If the list is older than this duration, a background sync (bw sync) is automatically started to fetch the latest updates from your vault.

Crucially, this refresh operation does not slow down Jenkins. The request that triggers the refresh is served the existing (stale) data immediately, while the new, updated list is fetched in the background for all subsequent requests. This keeps the UI responsive and ensures pipelines start without delay.

Note: The plugin never caches your actual secret values (passwords, keys, etc.). They are fetched "live" from the CLI's local, encrypted database at the exact moment a build needs them. This cache duration only controls how often that local database is updated.

This design also means Jenkins can continue to use your secrets even if it temporarily loses its internet connection, as it can read from the last successful sync.

A minimum value of 1 minute is enforced. The default is 5 minutes.