Description

This will automatically redirect visitors to the specified URL or Confluence page.

Heads up: Macros may not be available in Confluence upon installation

There is a known issue in Confluence Cloud (CONFCLOUD-58280) which prevents new macros from appearing in Confluence. Refer to this knowledge base (KB) article for recommended workarounds.

Parameters

Name

Required

Default Value

Description

Location

  • (/)

Specifies the Confluence page or URL to redirect to. For example:

  • http://www.randombits.org/

  • Quarterly Sales Reports

  • Quarterly Sales Reports^Q4_2018-Sales.xlsx (To redirect to a specific attachment on a particular page. This is for Server version only. To redirect to an attachment on the Cloud version, use the Confluence Attachment parameter instead.)

Confluence Attachment

  • (X)

The attachment to redirect to, which belongs to the specified Location. For example:

  • Q4_2018-Sales.xlsx

This is for Cloud version only. To redirect to an attachment on the Server version, refer to the example in the Location parameter.

Delay

  • (X)

0 (Server), 5 (Cloud)

The number of seconds to delay before redirecting the browser.

Visible

  • (X)

true

Select whether the information panel should be visible to the user or not.

Editor View

Macro Edit View

Notes

  • This macro does not keep track of whether the page being redirected to has had its name changed.

  • To edit a page which redirects instantly, add '?redirect=false' to the URL manually.

  • This macro uses JavaScript to redirect, so browsers with JavaScript turned off will have to click through manually.

  • On the Cloud platform, some browsers (e.g., Chrome) may attempt to block the redirect. If this happens, you will need to click the Pop-up Blocked icon in the address bar and configure the browser to always allow redirects for your Confluence site.

  • On the Cloud platform, you may be prompted to allow a redirect due to Atlassian's security policies. You may see a popup about "Redirection Notice". You will need to click Allow for the redirect to continue.

Tutorial Examples