Table of Contents



DokuWiki can convert text smileys to their graphically equivalent. The default images and the user defined images are automatically shown in the Smiley picker of the toolbar.

The default smileys images are stored in the lib/images/smileys/ directory and configured in the conf/smileys.conf file. Wiki admins can configure their own smileys, see below.

Customize smileys

To add your own smileys, and make them upgrade-safe as well, you should follow these instructions instead of mixing them with the default-smileys from Dokuwiki-package:

  1. Create a new folder called local inside the smileys-dir

    and put the imagefiles into it (make sure the images are readable by the webserver)

  2. Create a custom smiley-config file at

    and prefix each image filename with “local/…”

An example configuration file could look like this:

# Custom Smileys
# Images are seen relatively from the smiley directory lib/images/smileys/
:MYFACE:                local/i_am_so_pretty.jpg

# or eventually disable a smiley by mentioning the key, without image path.

Notes and hints

User provided additional smileys

The following smileys were created by DokuWiki users, using a similar style to the default ones. If you like them place them in your smiley directory and adjust the config file.

See also