User Macro for Confluence Cloud Documentation
Release Notes
š Security Notification
Atlassian Ecosystem Security identified a critical vulnerability (CVE-2025-7783) in the form-data dependency used by User Macro for Confluence Cloud.
Severity: Critical (CVSS 9.4)
Affected Versions: 2.4.0 (build 1002052)
Fixed In: 2.5.0 (build 1002062)
Remediation: Dependency upgraded to a patched version as recommended by Atlassian and Snyk.
The issue has been patched. While apps update automatically, we recommend verifying that you are running version 2.5.0 (build 1002062) or later.
š References:
š July 2025
July was largely focused on preparing User Macro for Confluence Cloud migration from Connect to Forge. Alongside this groundwork, improvements were made for Jira Assets support, while several bugs were fixed to improve reliability and embedded documentation consistency.
š June 2025
September introduced improvements to macro validation, fixed an issue with User Parameters editing, and enhanced navigation behavior in embedded OpenAPI documentation. These changes aim to tighten UX consistency and developer reliability, especially around importing and configuring macros.
š May 2025
May marked a breakthrough in macro functionality. Macros now render directly in edit mode and can include other macros as inner components ā even when passing User Parameters. This was achieved through a new internal rendering version with automatic migration. While the change introduced several complex issues, they were rapidly identified and resolved.
Instant Rerendering
Parameters Reordering
š April 2025
April introduced a powerful new feature for macro version control and focused on stability across browsers and developer tools. Admins can now track macro history and revert to prior versions, while small bugs impacting Firefox users and editor resource loading were resolved.
š March 2025
March prioritized user experience consistency and improved template debugging. Admin visibility was enhanced with better navigation, while developers gained more feedback for rendering issues and clearer variable handling in Velocity.
š January 2025
January focused on developer tooling and end-user support. Velocity templating gained improved error handling, and migration workflows were enhanced with support for custom macro keys. Usability improvements targeted both technical and non-technical audiences through better API access and interface polish.
š December 2024
December introduced quality-of-life improvements for macro management and author tracking. It also brought enhanced support for multi-value user parameters and gave administrators more control over macro availability through the new disable/enable system.
Multiselect Parameters
Multiple Authors and Macro Disabeling
š November 2024
In November, efforts were centered on improving macro template flexibility and preventing critical parameter-related errors. The addition of post-install UX guidance and enhanced template tooling improved both user onboarding and macro scripting capabilities.
## Sort spaces by name in descending order
#set($spaces = $ConfluenceManager.get("/wiki/api/v2/spaces"))
$SortTool.sort($spaces.results, ["name:desc"])
## Average with rounding
$MathTool.round($MathTool.getAverage($pagesCount))
š October 2024
October focused on stabilizing the user macro experience with targeted bug fixes and minor UX consistency updates. Improvements were made to flag behavior, visual alignment of input fields, and dynamic module registration during macro updates.
š September 2024 š
September marked the beginning of performance-focused optimizations and usability refinements. The team introduced support for static macros to improve rendering speed and standardized parameter handling to reduce potential user errors.
š August 2024
August focused on internal refactoring and improving UX reliability. A high-priority issue affecting macro import was addressed, while groundwork was laid for better form management and automated documentation generation for Jira integrations.
š July 2024
July was all about editor optimization and migration readiness. We introduced tooling to help users migrate their Server-based User Macros to the Cloud version with minimal manual effort. The editor experience also received a notable upgrade with support for native Apache Velocity syntax highlighting.
š June 2024
June brought focused improvements to the macro development experience and content sanitization logic. Notably, macro validation capabilities were enhanced for Velocity templates, and support was added for non-standard corporate URLs often blocked by aggressive sanitizers.
š May 2024 š¤
May marked a significant milestone for the User Macro for Confluence Cloud app. The core template engine transitioned from Handlebars to Apache Velocity, aligning the cloud experience with the legacy Confluence Server macros. This foundational change brings improved compatibility and opens the door to greater extensibility. In parallel, we focused on security upgrades, REST API helper automation, and UI safeguards.
## Ave, Velocity! #set($username = $currentUser.name) <p>Hello, $username!</p>
š April 2024
In April, focus was placed on improving macro interaction capabilities and user feedback mechanisms. Backend robustness was also improved through JSON validation for imports and a new macro copy endpoint. A critical issue affecting parameter persistence was resolved.
š March 2024
March brought significant backend improvements with the introduction of REST API v1 integration and documentation enhancements. Additionally, UX refinements were made for high-resolution displays and new contextual messaging was introduced to improve communication and branding.
š February 2024
February focused on stability improvements and subtle UX enhancements for macro template editing. Notably, it introduced more reliable handling of parameters and base URL contexts, as well as fixes for critical rendering bugs in new macros and helper logic.
š January 2024
January brought a wide range of foundational improvements to the User Macro for Confluence Cloud app. The focus was on expanding helper capabilities, improving macro editing UX, and addressing several critical and structural bugs for better stability and developer clarity.
š December 2024
December focused on improving stability around macro imports and ensuring better data isolation across customers. The helper interface received minor usability upgrades, while several bugs impacting macro reliability were addressed, including a high-priority issue involving leaked or broken macros.
š November 2023
November was packed with technical improvements and UI cleanup. A new client-side JavaScript whitelisting mechanism was introduced, performance was boosted through caching, and the macro editing experience received multiple refinements. Several complex casting and rendering bugs were also patched.
š October 2023
October centered on refining user access control, enhancing usability for admins, and improving data sharing and import flows. Feature limitations based on licensing were introduced, and user entities were enriched to better support permission management. Import safeguards and library usability also saw valuable updates.
š September 2023
September prioritized stability and usability in macro creation and documentation. Major efforts were made to support macro copying across instances, deliver accessible documentation, and refine user parameter behavior. Additionally, security and permission handling saw improvements with key bug fixes.
š August 2023
August delivered key architectural upgrades, improved helper documentation and usability, and aligned macro tooling more closely with modern API and UX standards. This month also brought fixes for serious errors affecting macro creation, saving, and dynamic content loading.
š July 2023
July focused heavily on stabilizing the macro creation and editing pipeline, refining UI interactions, and tightening error handling. Major issues related to macro availability, icon rendering, and backend failures were addressed, along with significant UX and UI streamlining for power users and new users alike.