Image and Media Handling in the Wiki

Last modified by Shur on Tue, October 9, 2007 12:14
Source|Old Revisions  

This is an old revision of the document!

You can upload and embed other files into DokuWiki pages with the Image Syntax. While images and Flash media are displayed right on the page, other files (such as PDF documents) are just linked to from the document. Please see mime for detailed information.

Uploading new files is done with the Media Manager called from the toolbar.

Just use the upload form on the lower right to upload a file. Optionally you can give a new name for the file. Be sure to keep the file extension correct! If you use new Namespaces in the name these will be created automatically.


To improve the performance for the user, DokuWiki tries to cache external images. If you want to use an external image without caching you can add the nocache parameter like this.


You can combine this parameter with resizing, too.


Hitting an external Server on every pageload isn’t very polite. Instead you can use the parameter recache to let DokuWiki to recache the image using the interval specified in the cachetime config option]]:



If PHP is installed with libGD support, resized versions of the embedded images are created on the server– if no GD support is found, it’s up to the browser to rescale the images after downloading.

Please note: libGD is often compiled without GIF support because of patent restrictions – GIF images will not be rescaled if no support for them is found.


DokuWiki allows you to put images in a page and have them link to a page providing details about the image or to a page that contains the full image. It also allows you to include images that do not link to any other page.

By default, clicking on an image brings up a “detail” page. The detail page is rendered by the detail.php template file. The standard detail.php file shows a larger version of the image along with a listing of EXIF and IPTC metadata contained within the the image (such as caption, author, date taken, etc.), along with other descriptive information.

The following syntax embeds an image in the page at full size, and clicking on this image produces a detail page providing metadata for the image:


Try clicking on this scaled-down image to see its detail page.

You may click on the image shown on the details page to get yet another page the contains only the image, shown at its actual size. Often you’ll embed the image on a page at a small size and show the image on a detail page at a medium size, so that only this final direct link provides the image at its full size.

You may instead embed an image on a page such that clicking on it brings you directly to the full image in its own page. This is called a “direct” link, and it’s indicated by appending the direct option to the image:


Try clicking on this scaled-down image to see its direct page.

It is also possible to embed an image in the page without having the image link to any other page. You accomplish this with the nolink option, as follows:


Try clicking on this image. Couldn’t do it, huh?

It is possible to resize an image by using ?50×50

Dynamic Images

Sometimes you may want to embed a dynamic image like this one

Using the usual method:


doesn’t work:


This is because DokuWiki assumes an image ends with .gif,.jpg or .png but this file ends with .php. The trick is to append an additonal CGI parameter like this: &.png – the CGI will ignore this unknown parameter but DokuWiki will think it’s an image.

You also need to add a questionmark at the very end or DokuWiki will think the CGI params are caching options.


BTW: You can find buttonmaker webfrontends at

If all else does not work, you can try adding the string “&dokuwiki_foobar=.png” and the end of the URL, and then encode the URL in a URL Encode site and then paste the Encoded URL in DokuWiki. Using the example URL from above, the resulting code will be:

{{|This is the resulting encoded URL used as a Image link}}

And the image in the wiki:
This is the resulting encoded URL used as a Image link

Note: might not work on development versions of DokuWiki

Removing Media