Enterprise Theme for Confluence
Space shortcuts
Space Tools
Enterprise Theme for Confluence BVTHEME

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.




This page tells you how to configure menus for the header and the footer.


The Enterprise Theme lets you embed a menu easily into the header and the footer. It's even possible to have different menus for different spaces. Furthermore, menus can be different depending on the users language.

Include Page
_Enable Enterprise Theme
_Enable Enterprise Theme
Include Page
_Export Theme Configurations
_Export Theme Configurations



On this page:

Table of Contents

Related pages:


  1. Choose the cog icon , at top right of the screen, then choose General configuration.
  2. Select Menus under Enterprise Theme in the left-hand panel. This will list the two default menus for the header and the footer as well as other menus that have been configured.


You can now:

  • Add a new menu by clicking the Add Menu button
  • Configure an existing menu
  • Edit the name of a menu
  • Delete a menu (the two global menus can not be deleted)


  1. Click the Configure link under Operations. This will open the menu structure of that menu.


Here you can:

  • Configure a menu structure for each language that is installed in Confluence. Users will see only the menu for the language they have set in their profile. However, users that have set a language for which there is no menu defined will see the default menu instead. The default language, which is marked with
    , is defined by the language that is set as the default language in Confluence. It is advisable to at least configure the menus for the default language as it is the "fall-back" menu.
  • Adding menu items:
    • Click the plus icon on a language section to add a menu item to that specific language menu.
    • Click the plus icon on a menu item to add a sub menu item. Menus can be up to tree levels deep.
    • Click the pencil icon  to edit an existing menu item.
    • Click the trash icon to delete an existing menu item. Be aware that this will delete all child items as well.
  • Reorder the menu by simply dragging the item by the menu icon on the left side. You can even drag menu items from one language section to another one.


TypeFiledMenu item is used for



grouping several items together. If this type is used on the top level of a menu, it acts as a drop-down menu. On the second menu level, groups are arranged horizontally and their children will be arranged underneath.

In the example below you see a header menu with the group Projects opened. The two child groups Star Fleet alpha and Star Alliance beta are arranged next to each other with their child items below them.

SpaceSpace pickerlinking to a space home page
PagePage search fieldlinking to a page
LinkAddress text fieldany other internet address such as http://www.bitvoodoo.ch, mailto://support@bitvoodoo.ch, etc.



This is the name of the item that will be displayed in the menu.


If a menu item should only be visible to certain Confluence groups, those groups can be specified here. Leave this field blank if all Confluence users are allowed to see the menu item. 

Open the link in a new tab


  1. Choose the cog icon , at top right of the screen, then choose General configuration.
  2. Select Sections under Enterprise Theme in the left-hand panel.
  3. Click on the section for the header or the footer. This will open the editor for that section.
  4. Make sure the Metamenu macro is present in the section by:
    • Click the Use Default button to reset the section. The default header section contains the Metamenu macro.
    • Add the Metamenu macro through the macro browser.
  5. Configure the parameter of the Metamenu macro:
    • Menu: Select the menu to be used.
    • Hide from anonymous user: If this checkbox is checked, anonymous users do not see the menu.
    • Style:
      • flat and menu3: With these two menu styles second level menu items are rendered in drop-downs and third level items are grouped together (see menu item types above as well). These two menus are preferred for header menus.

      • bv-footer: This style renders the every first level item of the menu into a column with the second level items being listed vertically below them. Items of the third level are not being rendered with this style. It is the preferred style for footer menus.


It is possible to have different header and footer menus in different spaces instead of the one defined globally. For this to make sense, at least one additional menu should be configured besides the Global Header and Global Footer. Please refer to the paragraph Adding, editing and deleting menus above.

To define menus in a space:

  1. Go to the space in which you would like to embed the menus.
  2. Navigate to the space administration. Please refer to the page Navigating to the Space Administration if you unsure how to find it.
  3. Select Sections under Enterprise Theme.
  4. Configure the Metamenu macro in the header and footer sections in the same way as you would do for the global sections. Please refer to the paragraph Embedding menus in the header and footer above.


For more information about editing sections go to the Sections documentation.


  • There is no menu defined for the language of your user profile and the default Confluence language.
    It is recommended to at least define a menu for the default language of Confluence. This way it is ensured that a users who have a language set in their profile for which there is no menu defined see the menu for the default language.
  • The menu is not embedded in the sections of the Enterprise Theme. Please refer to Embedding menus in the header and footer paragraphs above.

Why are certain menu entries not being displayed?


  • If the menu structure differs in different languages. If for instance you change the language in your user profile you would get a different language structure then.
  • If there are special restrictions on the menu item itself (can be configured on each menu item in the menu configuration, see restrictions on menu items above).
  • In case a space is linked in the menu: If you have permissions for this space and the start page of this space (see page restrictions).
  • In case a page is linked in the menu: Page restrictions which do not allow that you can see this page.


Enterprise Theme for Confluence BVTHEME