Custom Upload Dir
Choose your own upload folders using post titles, categories, dates and more. Keep files easy to find when browsing your server.
Choix
Yes — Custom Upload Dir is a safe, well-maintained plugin to use in 2026. It runs on 5K+ sites, is rated 4.4/5 and was last updated 1 month ago, and scores 86/100 on our health check.
- Testé avec le dernier WordPress (7.1)
Comment s'accumule-t-il ?
Côte à côte sur les installations, les mises à jour, les évaluations et le supportTéléchargements quotidiens
Les pics de téléchargement suivent généralement une nouvelle version - chaque site qui met à jour automatiquement compte comme un téléchargement.
Classements
Where Custom Upload Dir stands todayWordPress.org Classements de recherche
Position en direct dans la recherche de plugins, Top 100| Mot-clé | Position |
|---|---|
| fichiers | #85 |
| médias | >100 |
| organize | #21 |
| télécharger | #7 |
Adoption de version
Part de sites actifs par version.
Répartition des notes
★★★★★★★★★★ 4.4 from 25 reviews
About Custom Upload Dir
From the official readme · v3.6.0Description
Ever opened your uploads folder over FTP and wondered which post an image belongs to?
Custom Upload Dir lets you choose a folder structure that fits your site. Keep each post’s images together, group files by category or author, or separate PDFs from photos. Your files become easier to find on the server and easier to work with when making backups or moving your site.
Set up a path template once, then upload through WordPress as usual. Placeholders such as %postname% and %category% are filled in automatically for each new upload. You can combine them with ordinary folder names to create your own structure.
A few useful examples
Suppose you upload sunflowers.jpg to a post called “Summer in the garden”, published in July 2026 and filed under “Gardening”. These templates would put it in:
- A folder for each post:
/%postname%/→/summer-in-the-garden/sunflowers.jpg - Year, month, then post:
/%year%/%monthnum%/%postname%/→/2026/07/summer-in-the-garden/sunflowers.jpg - Category, then post:
/%category%/%postname%/→/gardening/summer-in-the-garden/sunflowers.jpg - Separate folders for file extensions:
/%file_ext%/→/jpg/sunflowers.jpg. A PDF would go in/pdf/.
These paths sit inside your site’s upload folder, usually wp-content/uploads. Post folders use the post’s URL slug, so a title such as “Summer in the garden” becomes summer-in-the-garden.
Make the structure your own
- Build paths from post slugs, IDs, dates, authors, the person uploading, file extensions and file types.
- Use categories, tags or your own custom taxonomies as folder names.
- Keep category hierarchies as subfolders, flatten them into a single folder name, or use just the top-level or most specific categories.
- Check example paths for your posts on the settings page before uploading files.
- Upload through the block editor or Media Library as usual.
- Add your own placeholders with a little PHP, if you need something specific to your site.
Start under Settings → Custom Upload Dir. Choose a default template, save it, and use the preview to check example destinations.
Different folders for posts, pages and Media Library uploads
Under Templates by parent post type, you can choose a different destination for uploads to Posts, Pages or a custom post type. The “parent” is the post or page you are uploading to. Each type has three choices:
- Use default: use the main template at the top of the settings page.
- Custom template: use a different template for this type. Leave the template empty to store files directly in the upload folder, without subfolders.
- Leave to WordPress: let WordPress choose the destination using its Media settings and any other upload plugins.
For example, keep Posts on Use default with /%year%/%monthnum%/, and give Pages the custom template /pages/%postname%/. An image uploaded to your “About” page would go in /pages/about/, while post uploads would keep their dated folders.
Uploads without a parent controls files uploaded directly through Media Library → Add New. It has the same three choices. For example, /library/%current_user_id%/ keeps these files together in folders for each uploader. Attaching a file to a post later does not move it.
All of these rules start on Use default, so upgrading does not change your destinations. Configure only the rules you want to use.
Folders by author or uploader ID
Use %author_id% for the post author’s numeric ID and %current_user_id% for the person uploading. They can differ when an editor uploads to another author’s post. For example, if user 12 uploads to a post by user 7, /authors/%author_id%/uploads-by/%current_user_id%/ becomes /authors/7/uploads-by/12/.
For Media Library uploads, use %current_user_id%: there is no parent post author, so %author_id% is left out. Uploads without a logged-in user leave out %current_user_id% too.
Choose the post date or the upload date
Use /%year%/%monthnum%/%day%/ for the post’s date, or /%upload_year%/%upload_month%/%upload_day%/ for the date the file is uploaded. Upload dates follow the timezone in your WordPress settings.
For example, an image uploaded on October 13, 2026 to a post dated March 5, 2019 goes in /2019/03/05/ with the post-date template, or /2026/10/13/ with the upload-date template. If there is no dated parent post, both templates use the upload date.
Existing files stay put. The template applies to new uploads; changing it does not move old files or change their URLs. Uploads made directly to the Media Library have no post, so post-specific parts of the template are left out. This organizes the actual files on your server; it does not add virtual folders to the Media Library screen.
Created by Ulf Benjaminsson.
Informations supplémentaires
Copyright (C) 2007-2026 Ulf Benjaminsson
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Installation
- Extract the
custom-upload-dir-folder and transfer it to the/wp-content/plugins/directory - Activez le plugin via le menu « Plugins » dans WordPress
- Customize your directory structure in
Settings -> Custom Upload Dir
Journal de modifications
Optional per-type and unattached templates, author/uploader IDs and explicit upload dates. Existing settings, upload destinations and files are preserved unless you configure a new rule.
3.6.0 (2026-10-13)
- Added separate upload templates for Posts, Pages and custom post types. Each can use the default template, its own template, or WordPress’s normal folders (thanks kristinachilds and pedjas for requesting this!).
- Added a separate template for uploads made directly through the Media Library (thanks somtam for the feedback on Media Library uploads!).
- Added
%author_id%and%current_user_id%for folders named after the post author’s or uploader’s numeric ID (thanks kryvulena for the request and aldemarcalazans for sharing an early solution!). - Added
%upload_year%,%upload_month%and%upload_day%for folders based on the upload date in your site’s timezone. Existing date tokens continue to use the post date (thanks jslanglois and aslynn for highlighting the confusion between these dates!). - Added path previews and clickable placeholders for the new templates.
- Updated French, German and Swedish translations and settings help.
Upgrading alone preserves existing destinations. No media is moved.
3.5.0 (2026-10-12)
Features and improvements
- A clearer settings page with clickable, keyboard-accessible placeholders and simpler explanations.
- Better path previews, including uploads without a post and feedback when a preview post cannot be found.
- Developers can now add custom placeholders using
cud_path_tokens, fixing the old approach that removed them before they could be replaced. The FAQ includes working examples (thanks jeffpannone and tomeagles!).
Correction de bugs
- Fixed cases where block-editor uploads used the wrong post’s details or lost the post information needed for the folder name.
- Fixed failed uploads affecting the folder chosen for a later upload.
- Fixed folder calculations that could accidentally remove part of the site’s upload base path.
- Fixed settings saves that could discard values. Invalid templates now show an error and keep the previous settings.
- Fixed the documented
%mime_type%placeholder and restored support for older placeholder names. - Fixed PHP notices when saved settings are missing taxonomy options (thanks aljuk!).
- Improved handling of missing authors and deleted categories.
Entretien
- Cleaned up older PHP code and made settings-page output safer.
- Updated the French translation and added German and Swedish translations for the settings page and messages.
- Reworked the help and examples to make choosing a folder structure easier.
- Minimum requirements are now WordPress 5.7 and PHP 7.4.
When upgrading: your saved template and existing files are kept. Dated folders now come only from your template: include /%year%/%monthnum%/ if you want them. Saving plugin settings no longer changes WordPress’s separate Media settings.
3.4.6 (2020-07-17)
- Fixed a null dereference error.
Changelog v. 3.4.5 (2020-05-05)
- added french translation (thanks, bibi699depreau!)
Changelog v. 3.4.4 (2019-03-24)
- Fixed a few PHP warnings
- Removed the %permalink% template as it broke uploads to drafts.
Changelog v. 3.4.3.2 (2019-03-24)
- Fixed ‘upload_dir’ not providing $post_id in Gutenberg editor.
Pour les développeurs
Est-ce votre plugin ? Montrez les chiffres.
Ajoutez un badge en direct à votre site, docs ou github readme. Il se met à jour par lui-même - aucun compte n'est nécessaire.
Best Custom Upload Dir alternatives
All files plugins →FAQ
Custom Upload Dir: quick answers
Réponses directes, extraites des données en direct WordPress.org.
Source : WordPress.org
Is Custom Upload Dir free?
Yes. Custom Upload Dir is free to download and use from the official WordPress.org plugin directory.
Is Custom Upload Dir safe to use in 2026?
Yes — Custom Upload Dir is a safe, well-maintained plugin to use in 2026. It runs on 5K+ sites, is rated 4.4/5 and was last updated 1 month ago, and scores 86/100 on our health check.
How many websites use Custom Upload Dir?
Custom Upload Dir is active on 5K+ WordPress websites and has been downloaded 115,707 times since it launched in December 2007. It was downloaded 1,980 times in the last 30 days.
Does Custom Upload Dir work with WordPress 7.1?
Yes. The developer has tested Custom Upload Dir up to WordPress 7.1.5, the latest release. It requires WordPress 5.7 or newer.
What PHP version does Custom Upload Dir need?
Custom Upload Dir requires PHP 7.4 or higher. Most hosts run PHP 8.x today, so it works on any modern WordPress hosting.
When was Custom Upload Dir last updated?
The latest version, 3.6.0, was released on October 13, 2026 (1 month ago).
Who makes Custom Upload Dir?
Custom Upload Dir is developed and maintained by ulfben.
What are the best alternatives to Custom Upload Dir?
The most popular alternatives to Custom Upload Dir are File Upload Types by WPForms (40K+ installs), Clean Image Filenames (30K+ installs) and File Manager (10K+ installs).
Propulsé par PageForge
Un modèle et une feuille de calcul. Une vraie page pour chaque recherche.
PageForge transforme chaque ligne d'un CSV en une page WordPress avec son propre titre, URL, SEO et schéma, construit sur la mise en page que vous Déjà conçu. Gratuit sur WordPress.org.
- CSV et XLSX, plus Google Sheets sur les professionnels et les entreprises
- Son propre titre, URL, SEO champs et schéma pour chaque page
- Fonctionne avec l'éditeur de blocs, Elementor, Divi et Avada
- Gratuit sur WordPress.org, pas de carte de crédit

