Repository navigation
[DevHub] wp_handle_upload_prefilter reference to upload_dir is unclear #2512
Description
Issue Description
The reference to upload_dir is broad, and should be narrowed.
Reported by itsseanl via User Contributed Notes.
URL of the Page with the Issue
https://developer.wordpress.org/reference/hooks/wp_handle_upload_prefilter/#more-information
Section of Page with the issue
More Information
Why is this a problem?
It's unclear to what is being referred.
Suggested Fix
Original:
Using this, in conjunction with the
upload_dir, you can
Fixed:
Using this, in conjunction with the
upload_dirfilter, you can
Activity
github-actions commentedon Sep 18, 2026
Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.
[-]`wp_handle_upload_prefilter` reference to `upload_dir` is unclear[/-][+][DevHub] `wp_handle_upload_prefilter` reference to `upload_dir` is unclear[/+]ahsanchowdhury commentedon Oct 2, 2026
I’d like to work on this documentation fix. /assign
ahsanchowdhury commentedon Oct 2, 2026
Thanks, I’ll work on this.
Proposed wording:
“Using this, in conjunction with the
upload_dirfilter, you can dynamically determine which directory to upload to, based on the files you upload.”I verified that
upload_diris a filter documented here:https://developer.wordpress.org/reference/hooks/upload_dir/
Please let me know whether this should be submitted as a documentation PR or updated directly in the Developer Reference.