Combining Macros
Combining macros gives you many more layout options. For example, you can put a Button macro inside a Tabs macro. Combining macros in this way gives you more control over your content. However, not all macros can be combined. Below are the most Frequently asked questions about combining macros.
How do I combine macros?
To combine macros you put one macro inside another one. For example, you could put a button inside a tab. Not every combination of macros works. To be able to combine macros you need one of them to be an open-box macro. This is the one that the other macros go inside. You can put closed box macros inside open box macros. You do this on the edit page in the same way you add any macro.
What's the difference between an Open Box macro and a Closed Box macro?
- Open Box Macros
- These are macros that are open to new content on the edit page. this is why you can put pther maros inside them. Use /or the + button to add closed box macros.
- Closde Box Macros
- The content of these macros can't be touched from the edit page. You have to open their editor to affect their content. On the edit page, they are just a placeholder image and may look a little different depending on the individual macro.
How can I figure out which macros can hold other macros?
Once you've set up a macro look at how it appears on the edit page. If you can add content to it on the edit page it is an open box macro, and in most cases, you can put closed box macros inside it.
If you can't click inside a macro on the edit page and add content, then it's a closed box macro. These macros can go inside open box macros.
Which macros are open box and which are closed box?
The Content Formatting Macros toolkit is split as follows:
What happens if you put an open box macro inside another open box macro?
You can't put one open box macro inside another one. If you try the second macro will appear below the first one, instead of inside it.
What does nesting mean?
Nesting is a term that is sometimes used to describe combining macros. It's used because one macro 'nests' inside the other macro.
Do all macros work inside Open Box macros?
Please see the following lists to check if the specific macro you are interested in works inside your open box macro.
Mosaic Macros
| Macro | Works As Normal | Notes |
|---|---|---|
| Alert Macro | The alert will display each time that the macro holding it is opened. | |
| Button Macro | ||
| Button Group | This type of macro will not fit inside another macro. | |
| BibTeX Reference Macro | References within tabs will only display in a Summary Macro in the same tab. | |
| BibTeX Summary Macro | The Summary Macro will only list BibTeX references within the same tab. | |
| Advanced Cards Macro | ||
| Footnote Macro | Footnotes within tabs will only display in a Summary Macro in the same tab. | |
| Footnote Summary Macro | The Summary Macro will only list Footnote references within the same tab. | |
| LaTeX Builder Macro | ||
| Progress Bar Macro | Works as long as there is only one progress bar on a page. If there are multiple nested progress bars on a single page it can cause a failure. | |
| Tabs Macro | This type of macro will not fit inside another macro. | |
| Tooltip Macro |
Atlassian Macros
| Macro | Works As Normal | Notes |
|---|---|---|
| Action Item | You can add the macro, but it doesn't keep it's status while in the tab. | |
| Attachments | This macro displays the attachements on the page. However the drag and drop upload function does not work. | |
| Blog Posts | ||
| Bullet List | ||
| Code Snippet | ||
| Contributors | ||
| Contributors Summary | ||
| Chart | This type of macro will not fit inside another macro. | |
| Change History | ||
| Children Display | ||
| Content by Label | ||
| Content Report Table | ||
| Create From Template | ||
| Date | ||
| Decision | ||
| Decision Report | ||
| Emojis | ||
| Error Panel | ||
| Excerpt | This type of macro will not fit inside another macro. | |
| Excerpt Include | ||
| Expand | If you wish to use this macro you can put it in the cell of a table, inside the macro. | |
| Files and Images | ||
| Gallery | ||
| Iframes | ||
| Include Page | ||
| Info Panel | ||
| Jira Charts | ||
| Jira Issues | ||
| Jira Legacy | ||
| Jira Roadmap | Only displays a link. | |
| Layouts | This type of macro will not fit inside another macro. | |
| Labels List | ||
| Link | ||
| Mention | ||
| Note Panel | ||
| Numbered List | ||
| Opsgenie Incident Timeline | ||
| Page Index | ||
| Page Properties | This type of macro will not fit inside another macro. | |
| Page Properties Report | This macro works as normal except when the table contains any other macros. | |
| Page Tree | ||
| Page Tree Search | ||
| Popular Labels | ||
| Profile Picture | ||
| Related Labels | ||
| Recently Updated | ||
| Recently Updated Dashboard | ||
| Roadmap Planner | The roadmap displays, but the links do not display when you hover over the bars. | |
| Shared Links Bookmark | ||
| Smart links | ||
| Spaces List | ||
| Status | ||
| Success Panel | ||
| Table | ||
| Table of Contents | ||
| Table of Content Zone | This type of macro will not fit inside another macro. | |
| Task Report | If you have enough tasks to result in multiple pages of tasks, you may not be able to scroll through the pages. | |
| Team Calendars | ||
| Trello Card | ||
| Trello Board | Although the board will display in edit mode, it does not display in view mode. | |
| User Profile | ||
| Warning Panel | ||
| Whiteboards | The link to the whiteboard is shown. | |
| Widget Connector |