Title: pre_recurse_dirsize
Published: December 9, 2020
Last modified: February 24, 2026

---

# apply_filters( ‘pre_recurse_dirsize’, int|false $space_used, string $directory, string|string[]|null $exclude, int $max_execution_time, array $directory_cache )

## In this article

 * [Description](https://developer.wordpress.org/reference/hooks/pre_recurse_dirsize/?output_format=md#description)
 * [Parameters](https://developer.wordpress.org/reference/hooks/pre_recurse_dirsize/?output_format=md#parameters)
 * [Source](https://developer.wordpress.org/reference/hooks/pre_recurse_dirsize/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/hooks/pre_recurse_dirsize/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/hooks/pre_recurse_dirsize/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/hooks/pre_recurse_dirsize/?output_format=md#wp--skip-link--target)

Filters the amount of storage space used by one directory and all its children, 
in megabytes.

## 󠀁[Description](https://developer.wordpress.org/reference/hooks/pre_recurse_dirsize/?output_format=md#description)󠁿

Return the actual used space to short-circuit the recursive PHP file size calculation
and use something else, like a CDN API or native operating system tools for better
performance.

## 󠀁[Parameters](https://developer.wordpress.org/reference/hooks/pre_recurse_dirsize/?output_format=md#parameters)󠁿

 `$space_used`int|false

The amount of used space, in bytes. Default false.

`$directory`string

Full path of a directory.

`$exclude`string|string[]|null

Full path of a subdirectory to exclude from the total, or array of paths.

`$max_execution_time`int

Maximum time to run before giving up. In seconds.

`$directory_cache`array

Array of cached directory paths.

## 󠀁[Source](https://developer.wordpress.org/reference/hooks/pre_recurse_dirsize/?output_format=md#source)󠁿

    ```php
    $size = apply_filters( 'pre_recurse_dirsize', false, $directory, $exclude, $max_execution_time, $directory_cache );
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/functions.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-includes/functions.php#L8817)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-includes/functions.php#L8817-L8817)

## 󠀁[Related](https://developer.wordpress.org/reference/hooks/pre_recurse_dirsize/?output_format=md#related)󠁿

| Used by | Description | 
| [recurse_dirsize()](https://developer.wordpress.org/reference/functions/recurse_dirsize/)`wp-includes/functions.php` |

Gets the size of a directory recursively.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/hooks/pre_recurse_dirsize/?output_format=md#changelog)󠁿

| Version | Description | 
| [5.6.0](https://developer.wordpress.org/reference/since/5.6.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fhooks%2Fpre_recurse_dirsize%2F)
before being able to contribute a note or feedback.