Skip to content

WordPress Filename Bug

A large Thank You goes out to Heather Klemann of English for alerting us to a bug in WordPress’s handling of certain characters in filenames when you upload files to the Media Gallery. In short, there are certain characters that won’t get handled properly by WordPress, leaving you with a file unreachable from the web browser. WordPress developers are aware of the bug but can’t agree whether it’s WordPress’s problem or a system administrator’s problem. For the time being, you are, unfortunately, the best source for the workaround.

Broadly speaking, you have two nonexclusive options:

  1. Avoid having any of the characters below in a filename you upload to Academic Commons.
  2. When you upload a file to the Media Gallery, verify that it has uploaded successfully by going to its entry in Media Gallery and accessing the View link you get when hovering over the entry. (On a mobile device you may need to tap the filename, then find and tap the View Attachment Page button.) For non-image files, you may need to click/tap the link in the post that then appears to check it.

We’ll follow this one with WordPress and let you know when it’s fixed or that it won’t be fixed. (For what it’s worth, the same roughly goes for Classes*v2.)

Character Description
Back slash
/ Forward slash
? Question mark
* Asterisk
" Quotation mark
: Colon
< Less than
> Greater than
# Hash mark
% Percent sign
+ Plus sign
Published inYale Academic Commons
Skip to toolbar