---
url: https://cachemanager.beyondthecloud.dev/caches/org.md
---
# Org Cache

Persistent caching shared across the entire org.

## Overview

Org cache stores data persistently using Salesforce Platform Cache, shared across all users and sessions in the org.

```apex
CacheManager.DefaultOrgCache
```

## Characteristics

* **Lifetime:** Until evicted or explicitly removed
* **Scope:** Entire org
* **Storage:** Platform Cache
* **Persistence:** Persistent across transactions
* **Sharing:** Shared across all users and sessions

## When to Use

Use org cache when you need to:

* Cache configuration data
* Store data shared across all users
* Cache expensive calculations used org-wide
* Reduce database queries for frequently accessed data

## Setup Required

Org cache requires Platform Cache setup:

1. Go to **Setup** → **Platform Cache**
2. Create a partition named `Default`
3. Allocate org cache capacity

## Basic Usage

```apex
// Store in cache
CacheManager.DefaultOrgCache.put('settings', orgSettings);

// Retrieve from cache
Settings__c settings = (Settings__c)
    CacheManager.DefaultOrgCache.get('settings');

// Check existence
if (CacheManager.DefaultOrgCache.contains('settings')) {
    // Use cached data
}

// Remove from cache
CacheManager.DefaultOrgCache.remove('settings');
```

## Example: Cache Configuration

```apex
public class ConfigService {
    public static Map<String, Object> getConfig() {
        String cacheKey = 'appConfig';

        if (CacheManager.DefaultOrgCache.contains(cacheKey)) {
            return (Map<String, Object>)
                CacheManager.DefaultOrgCache.get(cacheKey);
        }

        Map<String, Object> config = loadConfigFromCustomSettings();
        CacheManager.DefaultOrgCache.put(cacheKey, config);

        return config;
    }
}
```

## Example: Cache Metadata

```apex
public List<AccountType__mdt> getAccountTypes() {
    String cacheKey = 'accountTypes';

    if (CacheManager.DefaultOrgCache.contains(cacheKey)) {
        return (List<AccountType__mdt>)
            CacheManager.DefaultOrgCache.get(cacheKey);
    }

    List<AccountType__mdt> types = [
        SELECT Id, Type__c, DefaultOwner__c
        FROM AccountType__mdt
    ];

    CacheManager.DefaultOrgCache.put(cacheKey, types);
    return types;
}
```

## Cache Invalidation

```apex
// Invalidate when configuration changes
public static void updateConfig(Map<String, Object> newConfig) {
    // Update database
    saveConfig(newConfig);

    // Invalidate cache
    CacheManager.DefaultOrgCache.remove('appConfig');
}
```

## Best Practices

1. **Cache Read-Heavy Data** - Perfect for configuration, metadata
2. **Invalidate on Updates** - Remove cache when underlying data changes
3. **Use Reasonable TTL** - Don't cache data that changes frequently
4. **Monitor Capacity** - Platform Cache has storage limits

[See Examples →](/examples)
