How to allow Confluence Mobile to render a macro

Still need help?

The Atlassian Community is here for you.

Ask the community

This article is about Confluence mobile web (4.3.2 or later). It does not apply to the Confluence iOS app, which is available now for Confluence Cloud customers.

This article is for Confluence administrators seeking to customise the white-list of macros that will display in the mobile interface. If you are a developer looking to make your macro "mobile-compatible", then please consult our relevant developer tutorial - Making your macro render in Confluence mobile


The Confluence Mobile plugin will, by default, only render macros that are explicitly customised by their developer to be mobile compatible. However, there could be cases where your site uses macros that are no longer under development and you cannot access the source to make them mobile compatible. This article describes a worst case fallback that will allow you to enable these macros in mobile by modifying the internal white list of macros.


Non-mobile Macro Whitelist

To modify this whitelist you would need to uncompress the from your installation.

On 4.3.2 this is found in -


On 5.0 this is already uncompressed at -


Uncompress the contained confluence-mobile-<version>.jar file, edit pluginContext.xml and add your macro to the list that by default starts like -

pluginContext.xml snippet
<!-- Non-mobile specific macros which we will still allow to execute --> 
    <beans:value>macro you want to whitelist</beans:value>

You should then bundle the contents of confluence-mobile-<version>.jar back to a complete and single JAR file and install it via the Universal Plugin Manager.

Last modified on Jan 5, 2016

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.