Add 'User Macro' to 'Featured Macros' section of Insert menu

Hi, I have added a user macro to Confluence which will be frequently used by our staff. I would like to add it to the insert menu (in the featured macros section?) so that it can be used without opening the macro browser and locating it each time. Is this possible?

1 answer

1 accepted

2 votes
Accepted answer

Hi Greg,

For adding full blown macro plugins to the insert menu there's documentation available at I'm not sure if you can reference a user macro in a Web Item though as I've never tried to do this.

Hope that's of some help as a starting point??


Thanks Andrew, I don't think there's the easy way I hoped for to do this. Putting a plugin together seems like overkill, but it might be the only way!

Hi Greg,

This might be easier than I thought by just using the above link to create a plugin that just creates the menu item, but referencing the key of the user macro rather than having to convert the user macro to a macro plugin. Testing it now to see if it works.


Brilliant, thanks Andrew I'll try it out!

Yep it works with user macros, amazing what some sleep followed by caffeine can do :-)

  1. Create your user macro
  2. Download and install the Plugin SDK -
  3. Create a skeleton plugin -
  4. Edit pom.xml to provide your company name, URL and description
  5. Delete the file that the SDK creates
  6. Edit atlassian-plugin.xml so it's similar to the following:
<atlassian-plugin key="${project.groupId}.${project.artifactId}" name="${}" plugins-version="2">
        <vendor name="${}" url="${project.organization.url}" />

    <web-item key="editor-my-macro" name="Insert Last Login MAcro" section="system.editor.featured.macros.default" weight="100">
        <label key="Last Login Macro"/>
        <link linkId="lastlogin"/>

In the above example I tested with a user macro that I had created called "lastlogin" so just replace the label key and linkid with values that match your user macro.

7. Type atlas-run to run up a test instance of Confluence including the new item
8. Add you user macro to the test instance
9. Test that the menu item works
10. Run atlas-package to package your plugin so it can be installed on your real Confluence instance

NB. The macro browser only works with macros that have parameters so if your user macro does not have parameters that the user has to enter it won't work with the macro browser in general let alone via the new menu item.

Hope that makes sense? A bit of a rushed set of instructions as I need to head out, but I'll blog a more detailed solution and post it later.


Brilliant, followed your instructions and got it working, thanks!

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Feb 06, 2019 in Confluence

Try out the new editing experience

Hi team, I’m Avinoam, a product manager on Confluence Cloud, and today I’m really excited to let the Community know that all customers can now try out the new editing experience and see some of the ...

899 views 45 7
Join discussion

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