Cache Management
Overview
The cache management page lets you view all cached pages for a domain, purge cached entries when content changes, and warm the cache for important pages. Effective cache management ensures bots always see your latest content while maintaining fast response times.
Viewing Cached Pages
Navigate to a domain's Cache tab to see all currently cached pages. Each entry shows the URL path with a Purge button to remove it from the cache.
The cache is stored in Redis with a default TTL of 1 hour. After expiration, the next bot visit to that page triggers a fresh render.
Purging Cache
Purge a Single Page
When you update a specific page and want bots to see the changes immediately:
- Go to the domain's Cache tab.
- Find the page in the cached pages list.
- Click the Purge button next to that page.
The cached entry is removed instantly. The next bot visit will trigger a fresh render with your updated content.
Purge All Cache
After a major site update, you may want to clear all cached pages:
- Go to the domain's Cache tab.
- Click Purge All Cache.
- Confirm the action.
This removes every cached page for the domain. Subsequent bot visits will trigger fresh renders for each page. Be aware that this temporarily increases render times and load until the cache is rebuilt.
Cache Warming
Cache warming lets you proactively render pages before bots visit them. Instead of waiting for the first bot request (which takes 2-5 seconds to render), you can pre-render pages so bots get instant cached responses.
To warm your cache:
- Go to the domain's Cache tab.
- Click Warm Cache to re-render all previously cached pages for the domain.
Cache warming is especially useful after deploying a new version of your site, purging all cache, or adding a new domain. For more details on warming strategies, see Cache Warming.
Emergency Refresh
The domain detail page includes an Emergency Refresh button that re-renders all cached pages for the domain in one action. This is useful after deploying a major site update when you need all content refreshed immediately.
Emergency refreshes are limited per billing period based on your plan:
- Starter: 2 per period
- Pro: 5 per period
- Agency: 25 per period
- Agency+: 50 per period
The count resets when your billing period renews. See Plans and Pricing for details.
Cache Refresh Frequency
Your plan determines how frequently cached pages are automatically refreshed:
- Daily (Starter, Pro) -- Cached pages are refreshed once per day.
- Hourly (Agency) -- Cached pages are refreshed every hour.
- Real-time (Agency+) -- Cached pages are refreshed as content changes.
This is separate from the 1-hour cache TTL. The refresh frequency controls proactive cache updates, while the TTL controls when stale entries expire on demand.
Cache Statistics
The cache page header shows the total number of cached pages for the domain.
Best Practices
- Purge selectively -- Only purge pages that have actually changed. Purging everything unnecessarily increases render load.
- Warm after purging -- After purging important pages, immediately warm them so the next bot visit gets a cached response.
- Monitor hit rate -- A hit rate below 50% suggests that your cache is expiring faster than bots revisit. Consider warming your most-crawled pages regularly.
- Time updates wisely -- If possible, deploy site changes during low-traffic periods and warm the cache before peak bot activity.
Next Steps
- How Caching Works -- Understand the technical details of the caching system
- Purging Cache -- Detailed guide on cache purging strategies
- Cache Warming -- Advanced cache warming techniques