Filters the memory limit allocated for WP-Cron event processing.
Parameters
$filtered_limitint|string- Maximum memory limit to allocate for WP-Cron.
DefaultWP_MAX_MEMORY_LIMITor the original php.inimemory_limit, whichever is higher.
Accepts an integer (bytes), or a shorthand string notation, such as'256M'.
Source
$filtered_limit = apply_filters( 'cron_memory_limit', $filtered_limit );
Changelog
| Version | Description |
|---|---|
| 6.3.0 | Introduced. |
In this example, we’re assuming you are working within a WordPress environment and you want to adjust the memory limit for cron tasks. The
apply_filtersfunction allows you to apply a series of filters to a specific value, in this case, the memory limit. Thecustom_cron_memory_limitfunction acts as a filter callback, adjusting the memory limit by adding 128M to it.When you call
apply_filters('cron_memory_limit', ini_get('memory_limit'))WordPress will execute your custom function and pass the current memory limit value as an argument. Your function will then modify the limit and return the adjusted value, which will be used wherever theapply_filtersfunction is called. Finally, the adjusted memory limit is echoed out in the example.The
cron_memory_limitfilter is useful when your scheduled WP-Cron tasks require more memory than the default PHP memory limit allows — especially for operations like processing large product imports, running backups, or handling WooCommerce analytics jobs.Example: Set a fixed memory limit for cron tasks only
This ensures memory-intensive cron jobs don’t fail due to insufficient limits while respecting existing high limits set on the server. Always test memory usage to avoid over-allocating on shared hosting environments.