Links from macros

Anywhere a macro can link somewhere, it uses the same control: link to nothing, to a Confluence page, or to a URL.

Use the page picker rather than pasting a URL. A picked page survives being moved or renamed; a pasted URL does not.


#The three options

Option

When to use it

None

A card or button that is decorative, or that carries its own action

Page

Anything internal. Uses the Confluence page picker and survives moves

URL

External destinations, or a deep link the picker cannot express


#A few things worth knowing

  • A picked page renders as a proper link on a published site; a pasted internal URL may not resolve there.

  • External links from a macro are ordinary links and do not need an approved domain. Only fetched content does.

  • Card links export differently to a published site than they do in Confluence. Check the Cards page if that matters.



Pick the page. Do not paste the URL.