Summary
Upon installing a Confluence Cloud app, new macros bundled with the app are not available in Confluence. Symptoms include:
- The new macros are not listed in the Confluence macro browser.
- The new macros do not appear via keyboard shortcuts ("{" for old editor, and "/" for new editor) in Confluence page editor.
The macros may only become available after 24 hours, or in some cases, a few days.
Environment
Confluence Cloud
- Latest version of Composition Tabs for Confluence, Linking for Confluence, Redirection for Confluence or Visibility for Confluence for Confluence Cloud
Diagnostics Steps
Refreshing the web browser does not solve the problem.
Cause
There is a known issue in Confluence Cloud, reported at https://jira.atlassian.com/browse/CONFCLOUD-58280. It prevents macros of newly installed apps from appearing in Confluence due to a web caching problem.
Workaround
Apply ANY of the following workarounds:
- When viewing the Confluence page editor, "hard refresh" the web browser. This will force the web browser to clear web cache specific for the Confluence page editor.
- See the "How to Force Refresh a Single Page for All Browsers" section on this article for specific instructions for your web browser type and operating system.
- Clear the entire web browser cache. This will force the web browser to clear web cache for all websites.
- See the "How to Clear Browser Cache..." sections on this article.
- Work in incognito mode. This will require you to sign in to Atlassian Cloud.
- See this article for specific instructions on how to activate the mode.
The new macros should appear in your Confluence editor from now on.