It's better when it's simple

User Tools

Site Tools


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 its 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

Disable by mention the extension without a minetype. Disabling png-images by:


For configuration changes to take effect on the pages, the cache must be purged.

File type icons

File type icons can be added by placing an image file (SVG (develonly), PNG1) or GIF2)) 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

1) , 2)
Icons must be 16×16.
mime.txt · Last modified: 2022-05-08 07:22 by oiv

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki