Page Comparison

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 for Confluence Cloud of one of the following

  • 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.

This issue 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 forces the web browser to clear web cache specific for the Confluence page editor

• clear the entire web browser cache

  • this forces the web browser to clear web cache for all websites

• work in incognito mode

  • this requires you to sign in to Atlassian Cloud.

The new macros should appear in your Confluence editor after completing the workaround.