Your first macro

Every Capable macro works the same way: insert it, and a configuration panel opens. Most of them offer starter templates so you are editing something rather than staring at an empty form.

Cards is the best one to learn on, because almost every shared control appears in it.


#Step by step

Step

What you do

1

In the editor, type /Cards and pick the Capable macro.

2

Pick a starter template. Sixteen macros come with them, and Cards is one.

3

Change the titles and descriptions to your own.

4

Set a brand colour. That control is shared, so the same choice works across every macro.

5

Link each card to a page, using the page picker rather than typing a URL.

6

Publish, and look at it. Then change the column count and look again.

Cards macro Presets menu open, listing built in presets Feature highlights, Help hub and Image showcase, and organisation presets
Step 2. Open Presets to pick a starting point. The built-in ones sit at the top, with any your organisation has saved below them.
Cards macro Content tab with the Banana card expanded, showing its Title, Description, Link, Image and colour fields
Steps 3 and 5. Expand a card on the Content tab to change its title and description. The Link field sits just below them.
Cards macro Style tab with Columns set to 3 in the Layout section, plus alignment, gap, padding and appearance settings
Step 6. Columns is the first setting on the Style tab. Pick a different number, then look again.

#What to try next

  • A Banner at the top of a page, to give it a title people recognise.

  • Tabs, to break a long page into sections without splitting it into several pages.

  • Footnotes, if you write anything that cites sources.


#A few things worth knowing

  • Templates are a starting point, not a house style. Administrators can save real house presets separately.

  • The macro configuration form saves when you close it, like any Confluence macro.

  • If a setting appears to do nothing, check the macro's page. Several settings only apply in certain modes.



Insert, template, two edits, publish.