Notice: This plugin is deprecated. Trac 0.11 allows hiding and changing the labels of navigation items. Trac 1.3.2 allows items to be moved between the main and meta navigation.

Add another navigation bar and customize navigation items


This is a plugin that offers the following features:

  • Move navigation items between mainnav and metanav.
  • Hide navigation items.
  • Rename navigation items.

It is based on NavHiderPlugin. The components are left active, so you can still navigate to them directly or from other links.

Bugs/Feature Requests

Existing bugs and feature requests for NavControlPlugin are here.

If you have any issues, create a new ticket.


1 / 1


1 / 1


Download the zipped source from here.


You can check out NavControlPlugin from here using Subversion, or browse the source with Trac.


General instructions on installing Trac plugins can be found on the TracPlugins page.

To activate this plugin, add the following to your trac.ini file:

navcontrol.* = enabled


To hide items you can list them under [navcontrol] section as follows:

mainnav = search, newticket
metanav = about

To move items you can list them under [navcontrol] section as follows:

mainnav_to_metanav = tickets, wiki
metanav_to_mainnav = help

To rename items you can list them under [navcontrol] section as follows:

labels = browser:Code, tickets:Tickets


You can preface the item with

  • - or ! in the normal sort-order list to hide
  • @ or ^ in the normal sort-order list to move to the other nav bar
  • % or * followed by a : and new label to rename
mainnav = ^wiki,timeline,roadmap,%browser:code,@tickets,!newticket,-search
metanav = login,logout,settings,^help,-about

In this configuration you will have to provide both options if you want to combine both a move/hide and rename, for example:

mainnav = wiki,timeline,roadmap,browser,^tickets,%tickets:Tickets,newticket,search

to move tickets from the mainnav bar and to rename it as Tickets instead of the normal View Tickets.

Important: Enable WIKI_VIEW permissions for anonymous. See 3521 for details.

Recent Changes

16552 by rjollos on 2017-04-18 07:49:59
Fix indentation
4111 by tsooboi on 2008-08-02 18:10:58
Rolling back premature commit
4110 by tsooboi on 2008-08-02 17:47:03
Changes to improve code efficiency


Author: tsooboi
Maintainer: none (deprecated)

Last modified 3 months ago Last modified on Apr 18, 2017, 5:08:07 PM

Attachments (1)

Download all attachments as: .zip