---
title: "How to use the menu plugin in DokuWiki"
description: "DokuWiki has a plugin called the \"menu\" plugin that will allow you to place a custom navigation menu in your pages. This menu has nice icons separated out to each menu link catagory. The \"menu\"..."
url: https://www.inmotionhosting.com/support/edu/dokuwiki/custom-menu-plugin/
date: 2013-01-04
modified: 2021-08-16
author: "InMotion Hosting Contributor"
categories: ["DokuWiki"]
type: post
lang: en
---

# How to use the menu plugin in DokuWiki

DokuWiki has a plugin called the "*menu*" plugin that will allow you to place a custom navigation menu in your pages. This menu has nice icons separated out to each menu link catagory. The "*menu*" plugin that primarily works in the Wiki page code.  The following article will explain how to use the "*menu*" plugin.

**Important!** This menu only appears in the page you place the code in. To create a menu that is at the top of each page, [please visit here](/support/edu/dokuwiki/custom-css-menu/).

## Adding a menu to your DokuWiki with the menu plugin

The menu plugin can be a nice aesthetic to a page in your wiki. The menu plugin can be downloaded at the following link. Visit the following link and right click the download link on that page and save the link location.

[Download menu plugin](https://www.dokuwiki.org/plugin:menu)

You should have a link like the following.

ftp://ftp.berlios.de/pub/pbbuttons/plugin-menu.tgz

Take that url and use it in the following steps. The following steps will explain how to install install and use the menu module.

1. [**Log into DokuWiki**.](/support/edu/dokuwiki/login-dokuwiki/)
2. [![Click the Admin link DokuWiki](https://www.inmotionhosting.com/support/wp-content/uploads/2013/01/edu_dokuwiki_103_custom-menu-plugin_creating-menu-1-login.gif)](/support/wp-content/uploads/2013/01/edu_dokuwiki_103_custom-menu-plugin_creating-menu-1-login.gif) **Click Admin** at the top right.
3. [![Click Manage Plugins DokuWiki](https://www.inmotionhosting.com/support/wp-content/uploads/2013/01/edu_dokuwiki_103_custom-menu-plugin_creating-menu-2-manage-plugin.gif)](/support/wp-content/uploads/2013/01/edu_dokuwiki_103_custom-menu-plugin_creating-menu-2-manage-plugin.gif) **Click Manage Plugins.**
4. [![Install Direct from URL DokuWiki](https://www.inmotionhosting.com/support/wp-content/uploads/2013/01/edu_dokuwiki_103_custom-menu-plugin_creating-menu-3-install-direct-url.gif)](/support/wp-content/uploads/2013/01/edu_dokuwiki_103_custom-menu-plugin_creating-menu-3-install-direct-url.gif) **Paste the download link** in the *Download and install a new plugin*text box. In this case, the download link is the following. ftp://ftp.berlios.de/pub/pbbuttons/plugin-menu.tgz **Click Download** You should see a green confirmation box saying (1 plugin(s): menu) successfully installed. [![Upload images DokuWiki](https://www.inmotionhosting.com/support/wp-content/uploads/2013/01/edu_dokuwiki_103_custom-menu-plugin_creating-menu-5-installed-plugins.gif)](/support/wp-content/uploads/2013/01/edu_dokuwiki_103_custom-menu-plugin_creating-menu-5-installed-plugins.gif) The menu plugin will now show in the Installed plugin list.
5. [![Upload the images to DokuWiki](https://www.inmotionhosting.com/support/wp-content/uploads/2013/01/edu_dokuwiki_103_custom-menu-plugin_creating-menu-6-upload-images.gif)](/support/wp-content/uploads/2013/01/edu_dokuwiki_103_custom-menu-plugin_creating-menu-6-upload-images.gif) **Upload the icon images** to the page you are adding the menu to.
6. [![Insert the code for the plugin DokuWiki](https://www.inmotionhosting.com/support/wp-content/uploads/2013/01/edu_dokuwiki_103_custom-menu-plugin_creating-menu-6b-insert-code.gif)](/support/wp-content/uploads/2013/01/edu_dokuwiki_103_custom-menu-plugin_creating-menu-6b-insert-code.gif) **Add the following code to a page.** [Click here for how to edit a page](/support/edu/dokuwiki/edit-create-delete-restore-dokuwiki/).** ** <menu col=2,itemwidth=20,align=center,caption="Menu"> <item>Item name 1|Item descr 1|[]| {{Image 1}}</item> <item>Item name 2|Item descr 2|[]| {{Image 2}}</item> <item>Item name 3|Item descr 3|[]| {{Image 3}}</item> </menu> You will need to supplement the following for your menu items. **- Item name:** The text you want for the link. **- Item descr:** Text that follows the link with information. **- Wiki link:** The path to your wiki page. For example, frequently_asked_question. This is obtained be visiting the page and getting the last variable in the URL. **- Image:** This is the image name you uploaded in step 5. For example, email.gif. [![Final view of menu pluigin Dokuwiki](https://www.inmotionhosting.com/support/wp-content/uploads/2013/01/edu_dokuwiki_103_custom-menu-plugin_creating-menu-6a-final-view.gif)](/support/wp-content/uploads/2013/01/edu_dokuwiki_103_custom-menu-plugin_creating-menu-6a-final-view.gif) **Save the page** and now you should see the menu look like the snapshot to the right.