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.

You can find any file extension with its mime at, these are used since the Igor 2022 release.

For Hogfather 2020 release and older, the icons were created with the file icon generator. Old additional icons in the old style are available 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 mimetype. 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 SVG file named after the file extension into lib/images/fileicons/svg/. Note: because the stylesheet used for assigning the fileicons gets cached you need to force a rebuild by touching one of the config files or just save the Configuration Manager another time.

Since Igor 2022 release only SVG icons are automatically recognized. See also this forum post about a workaround .

From Hogfather 2020 and older only PNG1) or GIF2) are automatically recognized in the folder lib/images/fileicons/.

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
webp image/webp FIXME
ico image/
svg image/svg+xml
mp3 audio/mpeg
ogg audio/ogg
wav audio/wav
webm video/webm
ogv video/ogg
mp4 video/mp4
vtt text/vtt FIXME
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: 2023-07-13 08:42 by 2001:4c4c:1263:c500:45a1:2149:c129:39e3

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