# Troubleshooting stale and missing cached data

*Omnistudio Developer Study Guide · Troubleshooting and Debugging · Last updated October 27, 2026 · https://www.certifyforce.com/study-guide/omnistudio-developer/troubleshooting-and-debugging/troubleshooting-stale-and-missing-cached-data*

How to diagnose Omnistudio cache problems: different default lifetimes, caching that never happens in Preview, failed runs that cache nothing, cache headers and resetCache on REST calls, clearing Data Mapper and Integration Procedure caches with the Connect API, and turning off the Flexcard and Scale caches.

- Certification: Salesforce Omnistudio Developer
- Exam section: Troubleshooting and Debugging
- Study guide: https://www.certifyforce.com/study-guide/omnistudio-developer

**Official exam objective:**

> Resolve caching problems.

## What the exam expects

- Explain why cached data expires sooner or later than expected from each component's Time To Live defaults.
- Diagnose caching that never happens in Preview or after a failed run, and read the vlcCache nodes or REST headers.
- Clear Data Mapper or Integration Procedure caches with the Connect API, for one component or all of them.
- Name the partitions involved, and turn off the Flexcard cache or the Scale Cache when stale or sensitive data must not be cached.

Key terms: **Time To Live In Minutes** (how long cached data stays), **ignoreCache / resetCache** (options that skip the cache or force a save), **vlcCacheResult** (true when data came from the cache), **VlocityAPIResponse** (the partition for Cache Block output), **Scale Cache** (how Standard Runtime implements Org and Session Cache).

## Key facts

| Fact | Detail | Source |
|---|---|---|
| Cache Block TTL | Minimum 5; default 5; Org max 2,880, Session max 480 | [Cache Block](https://help.salesforce.com/s/articleView?id=xcloud.os_cache_block.htm&language=en_US&type=5) |
| Data Mapper Org Cache default | 1,440 minutes (24 hours) | [Data Mapper caching](https://help.salesforce.com/s/articleView?id=xcloud.os_configure_caching_for_data_mappers.htm&language=en_US&type=5) |
| Preview ignoreCache | Default true; set false to test caching | [Top-level caching](https://help.salesforce.com/s/articleView?id=xcloud.os_cache_for_top_level_integration_procedure_data_54841.htm&language=en_US&type=5) |
| Failed top-level run | Its data isn't cached | [Top-level caching](https://help.salesforce.com/s/articleView?id=xcloud.os_cache_for_top_level_integration_procedure_data_54841.htm&language=en_US&type=5) |
| REST cache values | vlcCache* nodes come back as headers | [Top-level caching](https://help.salesforce.com/s/articleView?id=xcloud.os_cache_for_top_level_integration_procedure_data_54841.htm&language=en_US&type=5) |
| Cache Block partition | VlocityAPIResponse | [Cache Blocks](https://help.salesforce.com/s/articleView?id=xcloud.os_enhance_performance_using_cache_blocks_48810.htm&language=en_US&type=5) |
| Clear all Data Mapper metadata | cacheStorageType Metadata, no dataMapperList | [Data Mapper performance](https://help.salesforce.com/s/articleView?id=xcloud.os_cache_for_dataraptors_and_integration_procedures_48057.htm&language=en_US&type=5) |
| Clear everything for one IP | CacheStorageType.All with its ipKey | [Caching overview](https://help.salesforce.com/s/articleView?id=sf.os_cache_for_dataraptors_and_integration_procedures_54751.htm&language=en_US&type=5) |
| Scale Cache off | TurnOffScaleCache = true in Omni Interaction Configuration | [Scale Cache](https://help.salesforce.com/s/articleView?id=xcloud.os_turn_off_the_scale_cache_55140.htm&language=en_US&type=5) |

## Check yourself

- Why can a Data Mapper's Org Cache stop working after a security change?
- When does an Integration Procedure with top-level caching save nothing to the cache?
- Why can a Data Mapper with no caching of its own still return cached data?
- Where do you turn off the Scale Cache?

## Sources

- [Improve Performance by Using Caching](https://help.salesforce.com/s/articleView?id=sf.os_cache_for_dataraptors_and_integration_procedures_54751.htm&language=en_US&type=5)
- [Cache Block](https://help.salesforce.com/s/articleView?id=xcloud.os_cache_block.htm&language=en_US&type=5)
- [Configure Caching for a Data Mapper](https://help.salesforce.com/s/articleView?id=xcloud.os_configure_caching_for_data_mappers.htm&language=en_US&type=5)
- [Cache for Top-Level Integration Procedure Data](https://help.salesforce.com/s/articleView?id=xcloud.os_cache_for_top_level_integration_procedure_data_54841.htm&language=en_US&type=5)
- [Enhance Performance by Using Cache Blocks](https://help.salesforce.com/s/articleView?id=xcloud.os_enhance_performance_using_cache_blocks_48810.htm&language=en_US&type=5)
- [Improving Data Mapper Performance with Caching](https://help.salesforce.com/s/articleView?id=xcloud.os_cache_for_dataraptors_and_integration_procedures_48057.htm&language=en_US&type=5)
- [Turn Off the Scale Cache](https://help.salesforce.com/s/articleView?id=xcloud.os_turn_off_the_scale_cache_55140.htm&language=en_US&type=5)
- [Disable Platform Cache for Flexcards in Omnistudio](https://help.salesforce.com/s/articleView?id=sf.os_disable_platform_cache_for_flexcards_in_omnistudio_38435.htm&language=en_US&type=5)

## About the full unit

The "Core concepts", "Exam traps" and "Worked scenario" sections of this unit, its 4 linked practice questions, and unlimited timed mock exams are included with the Omnistudio Developer pack (USD $19): https://www.certifyforce.com/practice-exams