Custom WordPress document libraries often create more than one URL for the same file. In one support case, users noticed that PDFs uploaded through a custom Document Center had both a direct uploads URL and a cleaner Document Center permalink.
The two links were not duplicates by mistake. They served different roles: the direct /wp-content/uploads/document-center-pdfs/... URL reflected where the PDF file was actually stored, while the cleaner /documentcenter/... permalink was created by the custom Document Center interface for public use. The developer recommended using the cleaner permalink in the public Document Center, confirmed that existing direct file links would continue working, staged the change, and then deployed it live after client approval.
Issue background
A WordPress site used a custom Document Center for public PDFs.
When a document was uploaded, users could encounter two different URLs for the same PDF:
/wp-content/uploads/document-center-pdfs/filename.pdf
/documentcenter/filenameBoth links opened the same document, which led to questions about why both existed, which should be shared publicly, and whether the site could standardize on one format.
Diagnosis
The developer confirmed that the two URLs represented two different layers of the same document.
The direct file URL:
/wp-content/uploads/document-center-pdfs/filename.pdfpoints to the actual stored PDF inside the site’s uploads directory. It is similar in concept to a normal WordPress Media Library file URL, although this custom Document Center stores its PDFs in a dedicated subdirectory.
The cleaner permalink:
/documentcenter/filenameis generated by the custom Document Center functionality. When opened, it serves the same PDF through a more readable, user-facing URL.
The developer recommended the /documentcenter/... permalink for public sharing because it was cleaner and appeared to be the intended public-facing format.
Importantly, switching the Document Center interface to use that permalink would not remove or invalidate the direct file URL. Both would continue to exist.
Resolution steps
The documented process was:
- Explain the purpose of each URL. The direct uploads URL represents the file’s storage location, while the Document Center permalink is the cleaner public-facing link.
- Recommend the cleaner permalink for public sharing. The developer advised using
/documentcenter/filenamein the public Document Center for a more consistent user experience. - Confirm that existing links would not break. Changing which URL the Document Center interface displays would not remove the existing direct file URLs.
- Stage the interface change first. The developer implemented the permalink change on staging and provided the updated Document Center for review.
- Answer a follow-up about the Media Library. The developer clarified that a normal PDF uploaded through the default WordPress Media Library would typically use a path such as:
/wp-content/uploads/filename.pdfIt would not automatically use the custom Document Center subdirectory.
- Clarify when to use the Media Library versus the Document Center. The Media Library is appropriate for general files used throughout pages and posts, while the custom Document Center is intended for documents that should appear in the public document-library interface.
- Get client approval. The client reviewed the staged change and approved it for production.
- Deploy the permalink change live. The developer pushed the updated Document Center behavior to production.
The source task does not document any redirect migration or deletion of direct file URLs. The change only altered which link format the public Document Center interface used.
Final outcome
The public Document Center was updated to use the cleaner /documentcenter/... permalink format.
Existing direct file URLs under /wp-content/uploads/document-center-pdfs/... continued to work, so previously shared links were not broken by the interface change.
The client also received clarification about the difference between the default WordPress Media Library and the custom Document Center: Media Library files are general WordPress attachments, while Document Center uploads are intended for documents that should be discoverable through the site’s dedicated public document interface.
The broader lesson is that multiple URLs for one document are not always a duplication problem. In custom WordPress systems, one URL may represent the physical file location while another provides a cleaner application-level permalink. Standardizing the public interface on the cleaner URL can improve usability without forcing a risky file migration.
If your WordPress document library creates confusing file URLs or you want to standardize how documents are shared publicly, contact Freshy. Our WordPress team can review the storage and permalink structure and help simplify the public experience without breaking existing links.
