Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Description

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

Note

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

Location

Status
title(/)

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

Status
title(

...

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

Status
title(

...

X)

0 (Server), 5 (Cloud)

The number of seconds to delay before redirecting the browser.

Visible

Status
title(

...

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

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
cqllabel = "redirect" and space = currentSpace ( )
labelsredirect