# \#macro

**URL:** https://community.developer.atlassian.com/tag/macro/134.md

[Latest](https://community.developer.atlassian.com/latest.md) · [Categories](https://community.developer.atlassian.com/categories.md) · [Tags](https://community.developer.atlassian.com/tags.md)

---

## [RFC-142: Confluence Migration Content Index for Macros](https://community.developer.atlassian.com/t/rfc-142-confluence-migration-content-index-for-macros/102090)

<div class="topic-metadata">

**Author:** [@DavidH](https://community.developer.atlassian.com/u/DavidH)\
**Replies:** 8\
**Last updated:** [October 15, 2026, 12:36am UTC](https://community.developer.atlassian.com/t/rfc-142-confluence-migration-content-index-for-macros/102090 "2026-10-15T00:36:43Z")

</div>

RFCs are a way for Atlassian to share what we’re working on with our valued developer community. It’s a document for building shared understanding of a topic. It expresses a technical solution, but can also communicate …

---

## [Support rendering Forge app macros in Embedded Confluence](https://community.developer.atlassian.com/t/support-rendering-forge-app-macros-in-embedded-confluence/102474)

<div class="topic-metadata">

**Author:** [@RahimHamani](https://community.developer.atlassian.com/u/RahimHamani)\
**Replies:** 2\
**Last updated:** [September 4, 2026, 9:46am UTC](https://community.developer.atlassian.com/t/support-rendering-forge-app-macros-in-embedded-confluence/102474 "2026-09-04T09:46:52Z")

</div>

Hello, We use the Embedded Confluence API (@atlaskit/embedded-confluence, ViewPage) to display Confluence Cloud pages on our own external web domain (e.g. \*.example.com). The page renders in an iframe whose top‑level do…

---

## [Content of Forge macros without body not discovered by Rovo](https://community.developer.atlassian.com/t/content-of-forge-macros-without-body-not-discovered-by-rovo/101882)

<div class="topic-metadata">

**Author:** [@lassenza](https://community.developer.atlassian.com/u/lassenza)\
**Replies:** 3\
**Last updated:** [July 30, 2026, 5:34am UTC](https://community.developer.atlassian.com/t/content-of-forge-macros-without-body-not-discovered-by-rovo/101882 "2026-07-30T05:34:21Z")

</div>

Hello, Rovo Assistant is not able to discover the content of Forge macros without a body (macros without a layout property in the manifest). For example, if you ask Rovo Chat to “Summarise this page”, the content of th…

---

## [Inline Macro Displays Differently When Nested in Rich Macros (ADF Export Issue)](https://community.developer.atlassian.com/t/inline-macro-displays-differently-when-nested-in-rich-macros-adf-export-issue/97509)

<div class="topic-metadata">

**Author:** [@SamiBelHajHassine](https://community.developer.atlassian.com/u/SamiBelHajHassine)\
**Replies:** 5\
**Last updated:** [May 8, 2026, 1:05am UTC](https://community.developer.atlassian.com/t/inline-macro-displays-differently-when-nested-in-rich-macros-adf-export-issue/97509 "2026-05-08T01:05:17Z")

</div>

I’m using Forge Custom UI for macros and noticed some strange behavior. Inline macros render correctly when they appear directly on a page, but when the same macro is nested inside a rich macro (for example, inside a Pan…

---

## [emitReadyEvent() rejects in normal Confluence page view - Is this expected?](https://community.developer.atlassian.com/t/emitreadyevent-rejects-in-normal-confluence-page-view-is-this-expected/98828)

<div class="topic-metadata">

**Author:** [@SueRocha1](https://community.developer.atlassian.com/u/SueRocha1)\
**Replies:** 1\
**Last updated:** [February 11, 2026, 8:57am UTC](https://community.developer.atlassian.com/t/emitreadyevent-rejects-in-normal-confluence-page-view-is-this-expected/98828 "2026-02-11T08:57:52Z")

</div>

Hi All, We are using a Forge Custom UI macro in Confluence and have configured the macro module with emitsReadyEvent: true in the manifest file and per docs calling await view.emitReadyEvent(); We added this in order t…

---

## [Popups are blocked in the iframe within the macro, with the message: "because the request was made in a sandboxed frame whose 'allow-popups' permission is not set."](https://community.developer.atlassian.com/t/popups-are-blocked-in-the-iframe-within-the-macro-with-the-message-because-the-request-was-made-in-a-sandboxed-frame-whose-allow-popups-permission-is-not-set/95409)

<div class="topic-metadata">

**Author:** [@huangzhihui](https://community.developer.atlassian.com/u/huangzhihui)\
**Replies:** 9\
**Last updated:** [December 17, 2025, 7:53am UTC](https://community.developer.atlassian.com/t/popups-are-blocked-in-the-iframe-within-the-macro-with-the-message-because-the-request-was-made-in-a-sandboxed-frame-whose-allow-popups-permission-is-not-set/95409 "2025-12-17T07:53:36Z")

</div>

I used Forge’s Custom UI to develop a macro with a configuration page. The macro renders an iframe, and the code for the rendering page is as follows: import React, { useEffect, useState } from 'react'; import { invoke,…

---

## [Find pages with forge macro](https://community.developer.atlassian.com/t/find-pages-with-forge-macro/49438)

<div class="topic-metadata">

**Author:** [@MWulff](https://community.developer.atlassian.com/u/MWulff)\
**Replies:** 9\
**Last updated:** [December 10, 2025, 11:10am UTC](https://community.developer.atlassian.com/t/find-pages-with-forge-macro/49438 "2025-12-10T11:10:52Z")

</div>

We want to list all pages with a specific forge macro. Normally you can do this by searching for pages with a macro via wiki/rest/api/content/search?cql=macro in ("iframe")&type=page. It works for built-in macros (like …

---

## [Get currentUser in user Macro](https://community.developer.atlassian.com/t/get-currentuser-in-user-macro/97335)

<div class="topic-metadata">

**Author:** [@DavidHpfl](https://community.developer.atlassian.com/u/DavidHpfl)\
**Replies:** 0\
**Last updated:** [November 26, 2025, 9:00am UTC](https://community.developer.atlassian.com/t/get-currentuser-in-user-macro/97335 "2025-11-26T09:00:08Z")

</div>

Hello Community, I want to create a user macro which mirrors the task report macro but sets the currently logged in user automatic as parameter, so basically its the taskreport macro but it gets dynamic for each user. M…

---

## [Hiding a Forge Macro and Handling Double Dialogs in Custom UI](https://community.developer.atlassian.com/t/hiding-a-forge-macro-and-handling-double-dialogs-in-custom-ui/96887)

<div class="topic-metadata">

**Author:** [@SamiBelHajHassine](https://community.developer.atlassian.com/u/SamiBelHajHassine)\
**Replies:** 2\
**Last updated:** [November 18, 2025, 10:25am UTC](https://community.developer.atlassian.com/t/hiding-a-forge-macro-and-handling-double-dialogs-in-custom-ui/96887 "2025-11-18T10:25:54Z")

</div>

I’m working on a Forge Custom UI macro for Confluence, and I’ve hit two issues I haven’t been able to solve yet, hoping someone has a workaround or insight: I want to hide my macro from displayed macro list in Conflue…

---

## [Forge Macro Export: Unable to Export Specific Page Versions](https://community.developer.atlassian.com/t/forge-macro-export-unable-to-export-specific-page-versions/95508)

<div class="topic-metadata">

**Author:** [@EvangelosMantadakis](https://community.developer.atlassian.com/u/EvangelosMantadakis)\
**Replies:** 1\
**Last updated:** [November 11, 2025, 2:31pm UTC](https://community.developer.atlassian.com/t/forge-macro-export-unable-to-export-specific-page-versions/95508 "2025-11-11T14:31:54Z")

</div>

I’m developing a Confluence macro using Atlassian Forge and need to export macro content based on a specific page version, not the latest version. However, I’ve discovered that Forge export functions don’t receive versio…

---

## [Forge Confluence macro not available on legacy editor](https://community.developer.atlassian.com/t/forge-confluence-macro-not-available-on-legacy-editor/67690)

<div class="topic-metadata">

**Author:** [@anon84015342](https://community.developer.atlassian.com/u/anon84015342)\
**Replies:** 9\
**Last updated:** [October 22, 2025, 10:05pm UTC](https://community.developer.atlassian.com/t/forge-confluence-macro-not-available-on-legacy-editor/67690 "2025-10-22T22:05:02Z")

</div>

Hi all, i’ve developed a page-version tool as confluence-forge-macro (UI-Kit). The customer has a lot of pages in the legacy-editor format. But the forge-macro is not available on the legacy-editor pages. My Question: …

---

## [Inline macro performance enhancing by sharing data](https://community.developer.atlassian.com/t/inline-macro-performance-enhancing-by-sharing-data/95035)

<div class="topic-metadata">

**Author:** [@Abdelhamed](https://community.developer.atlassian.com/u/Abdelhamed)\
**Replies:** 5\
**Last updated:** [October 13, 2025, 9:58am UTC](https://community.developer.atlassian.com/t/inline-macro-performance-enhancing-by-sharing-data/95035 "2025-10-13T09:58:51Z")

</div>

I have been developing a forge app for confluence with module inline Macro (UI Kit). due to the nature of the app, the user will create a lot of such macros in the same page. Each macro do 3 requests in the fronend, is …

---

## [Forge macros. How to check if user can edit page?](https://community.developer.atlassian.com/t/forge-macros-how-to-check-if-user-can-edit-page/51070)

<div class="topic-metadata">

**Author:** [@veloti](https://community.developer.atlassian.com/u/veloti)\
**Replies:** 2\
**Last updated:** [October 3, 2025, 6:40am UTC](https://community.developer.atlassian.com/t/forge-macros-how-to-check-if-user-can-edit-page/51070 "2025-10-03T06:40:49Z")

</div>

Hi Team, I’m developing confluence macro on Forge. I would like to disable some functionality if user have no permission to edit current page. How can I check if user can edit page (for example via rest api)? Thanks!

---

## [Rendering of Macro Body in Forge Confluence Macro](https://community.developer.atlassian.com/t/rendering-of-macro-body-in-forge-confluence-macro/95635)

<div class="topic-metadata">

**Author:** [@rr1](https://community.developer.atlassian.com/u/rr1)\
**Replies:** 5\
**Last updated:** [September 29, 2025, 9:41am UTC](https://community.developer.atlassian.com/t/rendering-of-macro-body-in-forge-confluence-macro/95635 "2025-09-29T09:41:25Z")

</div>

Hi there, I am new to Forge and I am writing my first macro that allows me to hide or show the contents in its body dependent on the value of a hide parameter. It basically works and there is no problem when the page i…

---

## [How to return an iframe in adfExport in a macro developed using Forge's custom UI](https://community.developer.atlassian.com/t/how-to-return-an-iframe-in-adfexport-in-a-macro-developed-using-forges-custom-ui/95464)

<div class="topic-metadata">

**Author:** [@huangzhihui](https://community.developer.atlassian.com/u/huangzhihui)\
**Replies:** 1\
**Last updated:** [September 22, 2025, 3:10am UTC](https://community.developer.atlassian.com/t/how-to-return-an-iframe-in-adfexport-in-a-macro-developed-using-forges-custom-ui/95464 "2025-09-22T03:10:39Z")

</div>

According to the tutorial: https://developer.atlassian.com/platform/forge/change-the-confluence-frontend-with-the-ui-kit/#specify-the-export-view, I can use adfExport to return most HTML pages to the page history, but it…

---

## [Confluence custom Plugin Doesn't gets enabled post upgrading from 7.13.11 to 9.2.5 version](https://community.developer.atlassian.com/t/confluence-custom-plugin-doesnt-gets-enabled-post-upgrading-from-7-13-11-to-9-2-5-version/95437)

<div class="topic-metadata">

**Author:** [@MahammadAYounus](https://community.developer.atlassian.com/u/MahammadAYounus)\
**Replies:** 3\
**Last updated:** [September 18, 2025, 10:07am UTC](https://community.developer.atlassian.com/t/confluence-custom-plugin-doesnt-gets-enabled-post-upgrading-from-7-13-11-to-9-2-5-version/95437 "2025-09-18T10:07:51Z")

</div>

Hello I have a custom plugin that defines page-classification that creates a Label. It was built years before it worked till 7.13.11 when I upgrade the confluence DC to 9.2.5, the plugin gets installed but never gets e…

---

## [Storing user entered data for Macro with Custom UI editor using forge](https://community.developer.atlassian.com/t/storing-user-entered-data-for-macro-with-custom-ui-editor-using-forge/74551)

<div class="topic-metadata">

**Author:** [@StaffanDevelop](https://community.developer.atlassian.com/u/StaffanDevelop)\
**Replies:** 7\
**Last updated:** [August 20, 2025, 7:30pm UTC](https://community.developer.atlassian.com/t/storing-user-entered-data-for-macro-with-custom-ui-editor-using-forge/74551 "2025-08-20T19:30:19Z")

</div>

After reading numerous threads and issues on the topic I need to confirm that I’m not missing something obvious :thinking: The use case is very straight forward: User edits a confluence page The user adds macro “/my-c…

---

## [Help with Custom Confluence Macro Rendering Issue (Forge App)](https://community.developer.atlassian.com/t/help-with-custom-confluence-macro-rendering-issue-forge-app/93710)

<div class="topic-metadata">

**Author:** [@cisotigain](https://community.developer.atlassian.com/u/cisotigain)\
**Replies:** 1\
**Last updated:** [July 10, 2025, 3:07am UTC](https://community.developer.atlassian.com/t/help-with-custom-confluence-macro-rendering-issue-forge-app/93710 "2025-07-10T03:07:38Z")

</div>

Hi everyone, Recently, I joined the Confluence training course and have been diving deeper into app development using Forge. I am currently working on a Forge app for Confluence, but I am running into an issue with a cu…

---

## [Confluence forge macro copy and paste in editor](https://community.developer.atlassian.com/t/confluence-forge-macro-copy-and-paste-in-editor/92359)

<div class="topic-metadata">

**Author:** [@UlrichKuhnhardtIzym1](https://community.developer.atlassian.com/u/UlrichKuhnhardtIzym1)\
**Replies:** 1\
**Last updated:** [June 10, 2025, 8:21am UTC](https://community.developer.atlassian.com/t/confluence-forge-macro-copy-and-paste-in-editor/92359 "2025-06-10T08:21:11Z")

</div>

I want to copy and paste a Confluence forge macro in the editor. Right now pasting a copied macro creates a vanilla version of the forge macro, as if there was no user input yet. However the source macro already has had…

---

## [Exporting macro to pdf not working](https://community.developer.atlassian.com/t/exporting-macro-to-pdf-not-working/92220)

<div class="topic-metadata">

**Author:** [@MateuszKny](https://community.developer.atlassian.com/u/MateuszKny)\
**Replies:** 18\
**Last updated:** [June 9, 2025, 6:26pm UTC](https://community.developer.atlassian.com/t/exporting-macro-to-pdf-not-working/92220 "2025-06-09T18:26:01Z")

</div>

Hey there, anybody having issue with exporting macro to pdf? I updated my app yesterday and since then can’t get export to work, it was working previously. I’m getting out of ideas, please help. I even created addition…

---

## [Do Atlassian Confluence Cloud API rate limits apply to custom macros hosted on our own cloud server?](https://community.developer.atlassian.com/t/do-atlassian-confluence-cloud-api-rate-limits-apply-to-custom-macros-hosted-on-our-own-cloud-server/92247)

<div class="topic-metadata">

**Author:** [@YUVARAJBYuvii](https://community.developer.atlassian.com/u/YUVARAJBYuvii)\
**Replies:** 0\
**Last updated:** [May 22, 2025, 7:33am UTC](https://community.developer.atlassian.com/t/do-atlassian-confluence-cloud-api-rate-limits-apply-to-custom-macros-hosted-on-our-own-cloud-server/92247 "2025-05-22T07:33:00Z")

</div>

Hi Atlassian team and community, I recently came across the announcement about API rate limiting(Rate Limiting-Documnet) for the Confluence Cloud REST API, and I wanted some clarification regarding our use case. We’ve …

---

## [Failed to Ioad ,The app's version is outdated... - while editing Configuration fields of Custom UI Confluence macro](https://community.developer.atlassian.com/t/failed-to-ioad-the-apps-version-is-outdated-while-editing-configuration-fields-of-custom-ui-confluence-macro/91561)

<div class="topic-metadata">

**Author:** [@DevelopMgr](https://community.developer.atlassian.com/u/DevelopMgr)\
**Replies:** 2\
**Last updated:** [April 30, 2025, 2:25pm UTC](https://community.developer.atlassian.com/t/failed-to-ioad-the-apps-version-is-outdated-while-editing-configuration-fields-of-custom-ui-confluence-macro/91561 "2025-04-30T14:25:22Z")

</div>

Hi, this message is shown while I’mm in Edit mode and pressing the “Edit Button” for editing the configuration fields of my Custom UI app. This app is running in production since a while. The screenshot is taken fr…

---

## [Confluence Macro. Render Storage format on page](https://community.developer.atlassian.com/t/confluence-macro-render-storage-format-on-page/91447)

<div class="topic-metadata">

**Author:** [@mikhail.gorev](https://community.developer.atlassian.com/u/mikhail.gorev)\
**Replies:** 3\
**Last updated:** [April 25, 2025, 5:35pm UTC](https://community.developer.atlassian.com/t/confluence-macro-render-storage-format-on-page/91447 "2025-04-25T17:35:54Z")

</div>

My template in vm: \<ac:link\>\<ri:user ri:username="${userName}"/\>\</ac:link\> Want to render storage format in macro output as normal html Only way that i found, just process my velocity template by xhtmlContent xhtmlCo…

---

## [True full-screen config in Forge Confluece macro](https://community.developer.atlassian.com/t/true-full-screen-config-in-forge-confluece-macro/90764)

<div class="topic-metadata">

**Author:** [@AlexM](https://community.developer.atlassian.com/u/AlexM)\
**Replies:** 2\
**Last updated:** [April 17, 2025, 7:37am UTC](https://community.developer.atlassian.com/t/true-full-screen-config-in-forge-confluece-macro/90764 "2025-04-17T07:37:28Z")

</div>

I’m looking for a way to provide a true full-screen experience within a Confluence Forge Custom UI macro. Previous discussions indicated this wasn’t possible. However, draw io announced their migration to Forge, and the…

---

## [Confluence Cloud Macro Not Rendering Content](https://community.developer.atlassian.com/t/confluence-cloud-macro-not-rendering-content/90708)

<div class="topic-metadata">

**Author:** [@YUVARAJBYuvii](https://community.developer.atlassian.com/u/YUVARAJBYuvii)\
**Replies:** 3\
**Last updated:** [March 27, 2025, 8:34pm UTC](https://community.developer.atlassian.com/t/confluence-cloud-macro-not-rendering-content/90708 "2025-03-27T20:34:29Z")

</div>

We are experiencing an issue with our Confluence Cloud instance where our custom macro is not rendering content as expected. The macro configuration part is functioning correctly, but the rendering of the macro content i…

---

## [Macro config update errors](https://community.developer.atlassian.com/t/macro-config-update-errors/89894)

<div class="topic-metadata">

**Author:** [@ThorstenKamann](https://community.developer.atlassian.com/u/ThorstenKamann)\
**Replies:** 3\
**Last updated:** [March 12, 2025, 10:05pm UTC](https://community.developer.atlassian.com/t/macro-config-update-errors/89894 "2025-03-12T22:05:01Z")

</div>

Hello, I am developed a macro that is using a custom config. On development it works fine, but at staging not. The is this error: Error: update(): The given ADFEntity cannot be inserted in the current position. Error: …

---

## [Confluence PDF & Word Export Issue with Prolaborate Macro (Cloud & Server)](https://community.developer.atlassian.com/t/confluence-pdf-word-export-issue-with-prolaborate-macro-cloud-server/89653)

<div class="topic-metadata">

**Author:** [@YUVARAJBYuvii](https://community.developer.atlassian.com/u/YUVARAJBYuvii)\
**Replies:** 0\
**Last updated:** [February 26, 2025, 3:29pm UTC](https://community.developer.atlassian.com/t/confluence-pdf-word-export-issue-with-prolaborate-macro-cloud-server/89653 "2025-02-26T15:29:47Z")

</div>

Issue Summary We have developed a Prolaborate macro for both Confluence Cloud and Confluence Server. The macro renders content correctly on Confluence pages, but we face issues when exporting to PDF and Word. Issues in…

---

## [Forge Custom UI Javascript Events, communicate between IFrames](https://community.developer.atlassian.com/t/forge-custom-ui-javascript-events-communicate-between-iframes/53687)

<div class="topic-metadata">

**Author:** [@nhac.tat.nguyen](https://community.developer.atlassian.com/u/nhac.tat.nguyen)\
**Replies:** 6\
**Last updated:** [January 29, 2025, 10:02am UTC](https://community.developer.atlassian.com/t/forge-custom-ui-javascript-events-communicate-between-iframes/53687 "2025-01-29T10:02:53Z")

</div>

Hi, I’m curious if in Forge, we have something similar to Events in Atlassian Connect Javascript API. I want to make some communication between my Macros on a Confluence page, both of them run on Custom UI. Thanks in …

---

## [Forge macro with editable body](https://community.developer.atlassian.com/t/forge-macro-with-editable-body/80482)

<div class="topic-metadata">

**Author:** [@guy1](https://community.developer.atlassian.com/u/guy1)\
**Replies:** 2\
**Last updated:** [January 8, 2025, 9:20am UTC](https://community.developer.atlassian.com/t/forge-macro-with-editable-body/80482 "2025-01-08T09:20:08Z")

</div>

Hi, I am trying to create a simple macro with editable body (just like the built in “Expand” macro). I managed to create a configurable macro (when clicking the pencil on the edit mode). please help me find an example …

---

## [How does "inline" macro work?](https://community.developer.atlassian.com/t/how-does-inline-macro-work/56779)

<div class="topic-metadata">

**Author:** [@remie](https://community.developer.atlassian.com/u/remie)\
**Replies:** 2\
**Last updated:** [December 10, 2024, 7:30pm UTC](https://community.developer.atlassian.com/t/how-does-inline-macro-work/56779 "2024-12-10T19:30:46Z")

</div>

I’m trying to create an inline macro similar to the Files & Images macro in Confluence Cloud (using Connect). The inline Files & Images macro allows users to adjust size, set page alignment and text wrapping options: …

[Next page](https://community.developer.atlassian.com/tag/macro/134.md?match_all_tags=true&page=1&tags%5B%5D=macro)
