Important notice: Migration of Advanced Tables for Confluence to Connect framework

Migration Completed!

The automatic migration of the Advanced Tables for Confluence app described on this page was completed on .  If you are migrating your instance from Confluence Server to Confluence Cloud today, please see Key differences between Advanced Tables for Server and Cloud for the current list of concerns and compatibility issues. 

On this page


Over the last year, we have been working closely with Atlassian Confluence development team to enable Advance Tables for Confluence to use the Atlassian Connect framework. This framework is the fundamental building block for Cloud apps going into the future of the Atlassian Cloud infrastructure. This effort is nearing completion and has reached a stage where Cloud user's of the Advance Tables for Confluence app is being gradually converted over to the new framework. This process has started and is expected to complete by the end of February, 2017.

2016-12-05 Update

Most instances have now been converted! Instances that have been identified as likely being impacted by known problem areas remain unconverted until improvements are available.


With this new approach for delivering the Advanced Tables app functionality, there are some key advantages.

  1. The ability for Advance Tables for Confluence improvements and fixes to be delivered more quickly to users. User instances automatically receive new and improved capability within minutes of them being formally released by the product development team. This compares to the previous approach where change could take weeks or months to flow through the Atlassian Cloud release procedure for non-connect apps.
  2. Minimizes cases or severity where Confluence Cloud updates may impact the proper behavior of Advance Tables for Confluence macros. While rare, we have experienced a few of these cases over the last few years that have caused customer pain. While this provides long term benefits, there are some near term disruptions.
  3. Allows Atlassian to deliver more significant infrastructure improvements for the benefit of all Cloud users.

What do administrators need to do?

Nothing for the conversion. The conversion is done by Atlassian at the appropriate time for your instance as part of the rollout staging.

Once your instance is converted, we recommend Administrators check any critical pages to ensure behavior is as expected. Please report any issues immediately after looking through the known problem list below.

Since this is a gradual rollout process, to know if your instance has been converted, go to Manage apps and expanding Bob Swift Atlassian Apps - Advanced Tables to view the version field. If the field looks something like 1.0.2-AC then you have been converted. Otherwise, it shows as 1.0.

What will macro users need to do?

 Nothing. Macros do not need to be changed; they continue to work similar to the previous support.

What will be different?

The macros involved are:

The key differences in behavior are:

  1. Macros render in the background and then appear as the data becomes available.
  2. The performance of the macro rendering are mostly dependent on the performance of the user's client machine as a majority of the processing is now done using the browser's Javascript engine. The way the Connect architecture works is that macros get loaded dynamically AFTER the page is rendered and displayed. This allows the page to be displayed to the user somewhat quicker, but then there is much more delay on each macro loading. The loading time is now more dependent on client Javascript speed (some browsers may be better than others) and network connections. Like it or not, this is a permanent restriction of the architecture.
  3. There may be difference is behavior of some interactions with other page elements or macros. The Atlassian Confluence development team continues to improve the integration and interactions of macros in the connect environment. Both teams are monitoring user scenarios that may be negatively impacted by inter-operability problems to develop appropriate resolutions. The conversion rollout has been planned to delay rollout to some instances that have situations not covered adequately by the current implementation.
  4. There are some other known issues that will be resolved over time. See below for details.

Reporting Problems

If you experience any problems or behavior changes that are unexpected, please do not hesitate to open a support issue (login required - see Help). This helps us identify and prioritize fixes and improvements.

Known issues

General issues

  1. Inter-operability between macros. Specifically rendering issues and differences. There have always been some compatibility problems between macros. This is more of an issue with connect based apps. The Confluence connect development team is working on improvements in this area based on likely use cases. CONF-41551.
  2. Chart macros using one of the Advanced Tables macros to provide data. This is actively being fixed by Atlassian and then will require an update to Advanced Tables. Instances with this scenario will not be converted until this issue is resolved. This has been resolved. All instances have now been converted.
  3. Anchor macros within Advance Tables for Confluence macros do not work. Atlassian has deemed this a permanent restriction. See CE-886 for details and feedback. Instances with this scenario will be converted in mid-Feb. 
  4. Mentions within Advanced Tables macros do not work. Fix will be available soon. CONF-44386 has been resolved.
  5. Tasks within Advanced Tables macros do not work. Fix will be available soon. CONF-44389 has been resolved.
  6. Sorting inline tasks in Connect macros does not work. See CONF-45450.
  7. Expand macro within Advanced Tables macros do not work. CONF-44384 has been resolved.
  8. Code macro within Advanced Tables macros do not workCONF-44387 has been resolved.
  9. Page properties macro within Advanced Tables macros do not work. CONF-45487 has been resolved. Instances with this scenario are still pending conversion. 
  10. Preview in macro editor does not work in many cases. Workaround is to use full page preview until the issue can be resolved. CE-685 and CE-13. Resolution is expected by mid-Feb.
  11. Style (css) macro on the page no longer active in Advance Tables for Confluence macros. See CE-890.
    • For table-plus, the workaround is to include the macro within the body of the table-plus macro.
  12. Export to PDF or Word does not include Advance Tables for Confluence macros. Workaround is to use browser's Print to PDF function. CE-907,   TBL-722 - Getting issue details... STATUS .
  13. Excerpt include macro results in 404 error when including a Connect macro. Atlassian is investigating. CE-876.
  14. Jira Issue/Filter macro inside a Table Plus macro does not show the Jira issues.  It shows an empty list.  See TBL-764, TBL-860 and CE-919. Update  The Jira Issue macro displays results but the formatting of the Table Plus macro is not being applied.  This is because the Jira contents are loaded asynchronously.
    1. Related is the Jira Issue macro when using the Total Issue Count option does not work when used inside Table Plus macro.  It just spins.  See  TBL-879 and CE-1047

Specific issues

key summary type assignee priority status resolution