It's better when it's simple

User Tools

Site Tools


Translations of this page?:

Learn about DokuWiki

Advanced Use

Corporate Use

Our Community

Follow us on Facebook, Twitter and other social networks.


MIME configuration

Which file types you can upload via the media manager popup or the fullscreen media manager is configured through the conf/mime.conf file. It also configures the file extension ↔ mimetype association.

For security reasons it is not possible to configure DokuWiki to allow any file type.

:!: Never enable HTML upload for unprotected wikis, as this opens Cross Site Scripting vulnerabilities through JavaScript. Only enable this with trusted users. You need to disable the iexssprotect option additionally to adding the HTML mime type in the config file.

The icons are created with the file icon generator. Old additional icons in the old style are available at

You can find any file extension with it's mime at

Adding additional Mime Types

Additional mimetypes should be added in mime.local.conf (you need to create this file). The file expects an extension (without the dot) and a mime type. Prefixing the mime type with an exclamation mark (!) will force the browser to present a download dialog, even if a browser plugin for the file in question exists.


# this would play in the browser (if supported):
wav         audio/wav

# this would be downloaded
wav         !audio/wav

File type icons can be added by placing an image file (PNG or GIF)1) named after the file extension into lib/images/fileicons/. Note: because the stylesheet used for assigning the fileicons gets cached you need to force a rebuild by touching one of the config files.

Default Mime Types

The default install contains the following configurations:

Extension Mime type Icon
jpg image/jpeg
jpeg image/jpeg
gif image/gif
png image/png
swf application/x-shockwave-flash
mp3 audio/mpeg
ogg audio/ogg
wav audio/wav
tgz !application/octet-stream
tar !application/x-gtar
gz !application/octet-stream
bz2 !application/octet-stream
zip !application/zip
rar !application/rar
7z !application/x-7z-compressed
pdf application/pdf
ps !application/postscript
rpm !application/octet-stream
deb !application/octet-stream
doc !application/msword
xls !application/msexcel
ppt !application/mspowerpoint
rtf !application/msword
docx !application/vnd.openxmlformats-officedocument.wordprocessingml.document
xlsx !application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
pptx !application/vnd.openxmlformats-officedocument.presentationml.presentation
sxw !application/soffice
sxc !application/soffice
sxi !application/soffice
sxd !application/soffice
odc !application/vnd.oasis.opendocument.chart
odf !application/vnd.oasis.opendocument.formula
odg !application/
odi !application/vnd.oasis.opendocument.image
odp !application/vnd.oasis.opendocument.presentation
ods !application/vnd.oasis.opendocument.spreadsheet
odt !application/vnd.oasis.opendocument.text

The following text types are commented by default, because spammers are known to upload spam pages through unprotected Wikis using text type files.

html text/html
htm text/html
txt text/plain
conf text/plain
xml text/xml
csv text/csv

See also

Icons must be 16×16.
mime.txt · Last modified: 2017-03-14 16:35 by