Skip to main content

Add a macro to a page

Add a Script Master macro to a page to show content your Confluence admin built. You insert Confluence's Custom Macro, then pick which Script Master macro it shows.

Applies to: Script Master for Confluence Β· Cloud

Before you begin​

  • Confluence permission: permission to edit the page.
  • App permission: none. A Confluence admin has created a macro in Script Master and turned it on. See Create a macro.
  • If the macro reads a macro body, check its description for what to type.

Add the macro​

  1. Open the page for editing.

  2. Type /, search for Custom Macro and insert it. Macro Configuration opens.

    The Confluence insert menu with Custom Macro, described as a Custom Scripted Macro made in Script Master

  3. In Select Macro, pick a macro.

  4. In Macro Body, type the input the macro expects, if any.

  5. In Maximum height (px), enter a height cap, or leave it blank to fit the content. Taller content scrolls inside the macro.

    The Macro Configuration dialog with Select Macro, Macro Body and Maximum height (px)

  6. Select Save, then publish or update the page.

Result: While you edit, the macro shows Selected Macro: with its title and description. On the published page, it shows its content to everyone who views the page.

If the macro shows "No custom macro selected", select it and then Edit (the pencil icon) to open Macro Configuration.

To change the macro or its body later, edit the page, select the macro and select Edit.

If the macro shows a message​

MessageWhat it means
A warning in Macro Configuration that the macro is no longer availableThe macro was switched off or deleted. Pick another one
Macro disabledA Confluence admin switched the macro off in Script Master
Macro errorThe macro can't load, for example because it was deleted
"This macro couldn't load."The macro's code failed. Your Confluence admin has been told. See Failures