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 Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Published yesterday in Marketplace Apps

Tips on how to choose the best estimation method for your planning

Planning and grooming sessions all come with their own sets of rules. Team members meet to estimate stories or other work items, all according to an agreed-upon process. And with every session comes ...

65 views 0 11
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