Redirect

Owned by
Elizabeth Tai
Last updated: Sept 20, 2023 by
Karina Zoin
2 min read

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 the knowledge base (KB) article for recommended workarounds.

Parameters

Name

Required

Default Value

Description

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.

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