Why am I getting unknown macro when using {hide-from} and {show-to} macros?

[Vivin Raj]

I want to hide content from particular users for which I am trying to use {hide-from} and {show-to}. But the preview gives me an error saying unknown macro. Can anybody help?

[Joseph Clark · Accepted solution]

Hi Vivin,

"hide-from" and "show-to" are not included by default with Confluence. These macros are part of the Visibility Plugin, which is by a third-party vendor named ServiceRocket, not Atlassian.

To use these macros, you can install the Visibility Plugin from the Atlassian Marketplace: https://marketplace.atlassian.com/plugins/net.customware.confluence.plugin.visibility

Instructions on how you can add new add-ons to your Confluence server can be found in our documentation: https://confluence.atlassian.com/display/UPM/Installing+Add-ons

Also note that installing new add-ons is not permitted if you are using Confluence OnDemand. In this case, you will not be able to use those macros.

[Vivin Raj]

Hi Joseph

Thanks a lot for the information. I am building a tool for my company and so I think they have Confluence OnDemand. So do you mean I cannot use these macros if I am using OnDemand? And is there any other default plugin supporting such features?

Thanks!

[Joseph Clark]

You can tell if your company is using Confluence OnDemand by the Confluence URL. If the URL ends with ".atlassian.net" (eg. "https://mycompany.atlassian.net"), then it is Confluence OnDemand.

I'm not aware of any default alternatives. One thing you could try is to put the content you want to restrict in a separate page. Then, set the permissions on that restricted page so that it is only visible to the users who you want to see it.

You can then use the "Include page" macro to take the content of the restricted page and put it in another page, where it will only be visible to users who have permission to see the restricted page.