---
title: "Cache.warmup ViewHelper <f:cache.warmup>"
manual: "Fluid ViewHelper Reference"
version: "13.4"
permalink: "https://docs.typo3.org/permalink/t3viewhelper:typo3fluid-fluid-cache-warmup@13.4"
source: "Global/Cache/Warmup.rst"
rendered: "2026-10-04T10:44:02+00:00"
---

# Cache.warmup ViewHelper `<f:cache.warmup>` {#typo3fluid-fluid-cache-warmup}

> [!WARNING]
> **Deprecated**
>
> Will be removed in Fluid v5

ViewHelper to insert variables which only apply during
cache warmup and only apply if no other variables are
specified for the warmup process.

If a chunk of template code is impossible to compile
without additional variables, for example when rendering
sections or partials using dynamic names, you can use this
ViewHelper around that chunk and specify a set of variables
which will be assigned only while compiling the template
and only when this is done as part of cache warmup. The
template chunk can then be compiled using those default
variables.

This does not imply that only those variable values will
be used by the compiled template. It only means that
DEFAULT values of vital variables will be present during
compiling.

If you find yourself completely unable to properly warm up
a specific template file even with use of this ViewHelper,
then you can consider using
`f:cache.disable` ViewHelper
to prevent the template compiler from even attempting to
compile it.

USE WITH CARE! SOME EDGE CASES OF FOR EXAMPLE VIEWHELPERS
WHICH REQUIRE SPECIAL VARIABLE TYPES MAY NOT BE SUPPORTED
HERE DUE TO THE RUDIMENTARY NATURE OF VARIABLES YOU DEFINE.

## Examples {#examples}

### Usage and effect {#usage-and-effect}

```
<f:cache.warmup variables="{foo: bar}">
   Template code depending on {foo} variable which is not
   assigned when warming up Fluid's caches. {foo} is only
   assigned if the variable does not already exist and the
   assignment only happens if Fluid is in warmup mode.
</f:cache.warmup>
```

Go to the source code of this ViewHelper: [Cache\\WarmupViewHelper.php (GitHub)](https://github.com/TYPO3/Fluid/blob/main/src/ViewHelpers/Cache/WarmupViewHelper.php).

**Arguments**

The following arguments are available for the cache.warmup ViewHelper:

-   **variables**

    -   *Type:* array
    -   *Default:* array (
    )

    Array of variables to assign ONLY when compiling. See main class documentation.