# Caching

URL: /docs/syntax/caching/
Section: syntax
Tags: syntax, caching

--------------------------------------------------------------------------------

Caching Kida provides built-in block-level caching to improve template rendering performance. Cache Directive Cache expensive template fragments: &#123;% cache &quot;sidebar&quot; %&#125; {# This content is computed once, then cached #} &#123;% for item in expensive_query() %&#125; {{ item.render() }} &#123;% end %&#125; &#123;% end %&#125; Dynamic Cache Keys Include variables in the cache key: &#123;% cache &quot;user-profile-&quot; + user.id %&#125; {{ render_user_profile(user) }} &#123;% end %&#125; Multiple components: &#123;% cache &quot;page-&quot; + page.id + &quot;-&quot; + page.updated_at %&#125; {{ page.content | markdown }} &#123;% end %&#125; Cache Configuration Configure caching in the Environment: from kida import Environment env = Environment( fragment_cache_size=1000, # Max cached fragments fragment_ttl=300.0, # TTL in seconds (5 minutes) ) Cache Stats Check cache statistics: info = env.cache_info() print(info[&quot;fragment&quot;]) # {&#x27;size&#x27;: 50, &#x27;max_size&#x27;: 1000, &#x27;hits&#x27;: 500, &#x27;misses&#x27;: 50} Clear Cache Clear cached fragments: # Clear all fragments env.clear_fragment_cache() # Clear all caches (templates + fragments) env.clear_cache() Best Practices Good Cache Keys {# ✅ Includes version for invalidation #} &#123;% cache &quot;post-&quot; + post.id + &quot;-v&quot; + post.version %&#125; {# ✅ Includes user for personalization #} &#123;% cache &quot;dashboard-&quot; + user.id %&#125; {# ✅ Includes locale for i18n #} &#123;% cache &quot;nav-&quot; + locale %&#125; Avoid Overcaching {# ❌ Too broad - caches everything #} &#123;% cache &quot;page&quot; %&#125; {{ page.content }} &#123;% end %&#125; {# ✅ Scoped to specific content #} &#123;% cache &quot;page-content-&quot; + page.id + &quot;-&quot; + page.updated %&#125; {{ page.content }} &#123;% end %&#125; Cache Heavy Operations Good candidates for caching: Complex database queries Markdown/RST rendering External API calls Expensive computations &#123;% cache &quot;recent-posts&quot; %&#125; &#123;% for post in get_recent_posts(limit=10) %&#125; {{ post.title }} &#123;% end %&#125; &#123;% end %&#125; Nested Caches Caches can be nested: &#123;% cache &quot;sidebar&quot; %&#125; &lt;aside&gt; &#123;% cache &quot;popular-tags&quot; %&#125; {{ render_tag_cloud() }} &#123;% end %&#125; &#123;% cache &quot;recent-posts&quot; %&#125; {{ render_recent_posts() }} &#123;% end %&#125; &lt;/aside&gt; &#123;% end %&#125; Cache Bypass For debugging, you can temporarily disable caching: # Development: smaller cache, shorter TTL env = Environment( fragment_cache_size=10, fragment_ttl=1.0, # 1 second ) See Also Performance — Performance optimization Configuration — Environment options Rendering Contexts — Context passing

--------------------------------------------------------------------------------

Metadata:
- Word Count: 350
- Reading Time: 2 minutes