How to customize the menu bar of Confluence's editor?

Confluence (in my case: v4.2.2) provides easy access to a number of macros in the 'insert' drop down menu. More macro options are available at the bottom of the list in an extra window.

When working with confluence I realize that most macros we use quite often are in the extra macro window, while we rarely use the predefined dropw-down macros at all. Is there a way to customize the content od the drop down menu?

I know that the macros are also available by auto comple, but many of the guys I am working with are more comfortable with a menu solution (so they don't have to memorize macro names.)

Many thanks inadvance.

3 answers

1 accepted

Hallo Marcel

We've just published a tutorial that does this very thing, by adding a plugin:

I hope this helps. :)

Cheers, Sarah

Great, thanks to you and Giuliano for your answers.

1 vote

One way you can do this customization is to modify the .xml file that maps the entries in the 'Browse' dropdown to the appropriate links. The .xml is located inside <confluence_install>/confluence/WEB-INF/lib/confluence-x.x.x.jar. Extract that and locate ./plugins/space-tabs.xml within.

Somewhere in there you should see:

<web-item key="space-administration" name="Admin Tab" section="" weight="70">
		<label key="space.admin" />
		<link linkId="space-admin-link">/spaces/editspace.action?key=$generalUtil.urlEncode($helper.spaceKey)</link>
        <condition class="com.atlassian.confluence.plugin.descriptor.web.conditions.HasSpaceCondition"/>
        <condition class="com.atlassian.confluence.plugin.descriptor.web.conditions.SpacePermissionCondition">
            <param name="permission">administer</param>
        <tooltip key="">
            <param name="param1">$</param>

You can modify the option performing the changes on specify "<web-item key>";

Stick this modified .xml in the following location so that it overrides the standard one in the .jar (you may need to create the 'plugins' directory:


Restart Confluence and see how it goes.

Remember to backup any files that will be modified before perform the action.


Suggest an answer

Log in or Join to answer
Community showcase
Jason Wong
Published yesterday in Agility Beta

Welcome to agility

Every team in the world is unique, and so   Atlassian believes   that each and every team's best way of working  needs to  be molded to their unique circumstances  – ...

372 views 6 16
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot