apply_filters( 'upload_dir', array $uploads )

Filters the uploads directory data.

Parameters

$uploads

(array) Array of information about the upload directory.

  • 'path'
    (string) Base directory and subdirectory or full path to upload directory.
  • 'url'
    (string) Base URL and subdirectory or absolute URL to upload directory.
  • 'subdir'
    (string) Subdirectory if uploads use year/month folders option is on.
  • 'basedir'
    (string) Path without subdir.
  • 'baseurl'
    (string) URL path without subdir.
  • 'error'
    (string|false) False or error message.

More Information

This hook allows you to change the directory where files are uploaded to. The keys and values in the array are used by the wp_upload_dir() function in wordpress core, which is doing the work

Source

File: wp-includes/functions.php

View on Trac

Used By

Used By Description
wp-includes/functions.php: wp_upload_dir()

Returns an array containing the current upload directory’s path and URL.

Changelog

Version Description
2.0.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/upload_dir