Breadcrumbs

App Platform Upgrade: Connect to Forge Migration Guide

We are upgrading the underlying platform of our QC Read & Understood app from Atlassian Connect to Atlassian Forge. This update ensures better data security, compliance with Atlassian Cloud standards, and improved reliability.

Why We’re Making This Update

We are migrating our QC Read & Understood app’s framework because Atlassian has officially announced the End of Support for Atlassian Connect. As Atlassian transitions all Cloud apps to Forge to enhance native security and infrastructure standards, Connect apps will no longer receive any new feature additions or long-term maintenance. By completing this migration to Atlassian Forge, we ensure our app remains fully supported, compliant, and continuously updated according to Atlassian’s latest platform changes.

Most importantly, this migration guarantees that we can keep helping and providing the support that you need when using the QC Read & Understood app. Rest assured, your data stays completely safe, and everything is still working fine.

What We Changed

While most of the functionality remains identical, this update introduces one major change to align with native Forge interactions and several new features that improve the app. Please note that no data will be lost during this transition. To complete the upgrade, site admins will need to perform a manual update by following the steps in the “How to Complete the Upgrade” paragraph at the end of this article.

Feature Continuity & Enhancements

We want to reassure our users that no existing features have been removed in this update. Every functionality you rely on in the current version remains fully available. We have simply made minor changes to align specific workflows with Atlassian’s native Forge interactions, while also introducing brand-new features to enhance usability and overall app performance.

Major Changes

Feature/Area

Previous versions (Connect)

New version (Forge)

Read & Understood (R&U) for Older Versions

Users could R&U an older version directly from the page via: Page ➔ ... (More Actions) ➔ Version History.

Discontinued from the Version History menu due to platform limitations.

Users must navigate to the QC R&U My Overview page, find the older version of the page they want, and click “Read and Understood”.

image-20260813-090931.png

Minor Changes

Feature/Area

Previous versions (Connect)

New version (Forge)

Location change of QC R&U Space Overview

Users had to navigate to: Space settings → App links → QC Read & Understood → Overview

image-20260813-074016.png


Now users will have to go to: Space Apps (left sidebar) → QC R&U Space Overview → Overview

image-20260813-072954.png

Location change of QC Acknowledgements

Users had to navigate to: Space settings → App links → QC Acknowledgements

image-20260813-074708.png

Now users will have to go to: Space Apps (left sidebar) → QC R&U Space Overview → Acknowledgements

image-20260813-080936.png

Location change of QC R&U Space Settings

Users had to navigate to: Space settings → App links → QC Read & Understood → Settings

image-20260813-074045.png


Users will have to navigate to: Space settings → Integrations→ QC Read & Understood → Settings

image-20260813-074140.png

Location change of QC R&U Analytics

Users had to navigate to: Space settings → App links → QC Read & Understood → Analytics

image-20260813-074510.png

Users will have to navigate to: Space settings → Integrations → QC Read & Understood → Analytics

image-20260813-080737.png

Location change of QC R&U Space History

Users had to navigate to: Space settings → App links → QC Read & Understood → History

image-20260813-074541.png

Users will have to navigate to: Space settings → Integrations → QC Read & Understood → History

image-20260813-080819.png

Location change of QC R&U My Overview

Users had to click on their profile icon and select the QC R&U My Overview option

image-20260813-075008.png


Now users will have to go to: Apps → QC R&U Global → My Overview

image-20260813-080111.png

Location change of Personal settings

  • For R&U Notifications: Users had to navigate to: profile icon → personal settings → QC R&U Email Notifications

    image-20260813-075126.png

  • For OTP Authentication: Users had to navigate to: profile icon → personal settings → QC R&U OTP Authentication

    image-20260813-075152.png

Now users will have to go to: Apps → QC R&U Global → Personal Settings

image-20260813-080408.png

Location change of QC R&U Site Overview

Users had to navigate to Apps → QC R&U Site Overview

image-20260813-075814.png

Now users will have to go to: Apps → QC R&U Global → Site Overview.

image-20260813-080033.png

Location change of QC R&U Site Admin

Users had to navigate to Confluence administration → Configuration → QC R&U Site Admin

image-20260813-081213.png


Now users will have to go to: Confluence administration → Apps → QC R&U Global Settings

image-20260813-081255.png

New Features

Feature

Description

Disable OTP Authentication on user level

Users will be able to disable OTP Authentication on a personal level.

In previous versions, if someone wanted to disable OTP, they’d have to click “Re-register device” and not complete the action.

image-20260813-081834.png

Extended Site Admin settings:

  • Configure the R&U statuses that will be displayed in QC R&U My Overview: Site admins can choose which R&U statuses will be displayed in the QC R&U My Overview table, according to their workflow.

    image-20260813-081915.png

  • Restrict macro usage to specific user groups

    image-20260813-082011.png

  • Customize standard R&U table headers such as “Page” and “Reviewer”

    image-20260813-082040.png

  • Synchronize users, pages and statuses across your whole site

    image-20260813-082053.png

Acknowledgement improvements

Simple improvements to the QC Acknowledgements feature include:

  • Users can now delete canceled acknowledgements

  • Users can search for groups and labels in the corresponding fields.

  • Due date can now be rule-based

    image-20260813-083130.png

  • Notify the assigned users that the due date has passed

    image-20260813-083259.png

  • Acknowledgement automated reminders now support custom monthly frequencies, letting users pick both the month interval and the exact day

    image-20260813-084543.png

  • Notify extra users about the progress of the Acknowledgement

    image-20260813-084257.png

  • Users can now filter the Acknowledgement report by which pages have enabled the QC R&U byline dialog.

Space and Page History Log improvements

  • Space history now stores entries for all space settings.

  • Page History → Display by Version:

    • Use the “Only significant” filter to show only the page property versions significant for Read & Understood.

      image-20260813-084959.png

    • Includes the users' email addresses along with their usernames.

      image-20260813-085054.png

  • Page History → Display by Action: Users can now export a table with all actions taken on a single page.

QC R&U My Overview → Display by Acknowledgements improvements

  • Removed hyperlink from Acknowledgement title. Now, when users click the title of an Acknowledgement, it opens a child table with all the included pages.

  • To navigate to the Acknowledgement’s page, we added a link button that users can click and land on the Acknowledgement.

    image-20260813-085313.png

  • Use the “Page labels” filter to see Acknowledgements that include pages with the selected label(s).

    image-20260813-085326.png

Space settings Improvements

  • When changing version strategies, the app will open a pop-up dialog letting users know that the change will affect their R&U data, and they can confirm if they want to proceed or not.

    image-20260813-085359.png

  • When using Confluence version strategy, users can configure if they want the app to consider a specific page status before the versions are ready for R&U

    image-20260813-085446.png

  • When setting up automated reminders, users can now select which R&U statuses the reminders apply to, depending on their workflow.

    image-20260813-085544.png

  • Added Greek to the available languages to translate the app.

    image-20260813-085611.png

R&U Overview tables (Site Overview, Space Overview)

Added a status overview with the overall statistics of:

  • Space Overview

    image-20260813-090104.png

  • Site Overview:

    image-20260813-090231.png

How to Complete the Upgrade

To complete the upgrade to the Forge version, a Site Admin must update the app manually by following the steps below:

  1. Go to Administration (from the top left menu),

    image-20260813-094626.png

  2. Find the site that you have installed the QC Read & Understood app (if you have more than 1 sites) and click Select

    image-20260813-094930.png

  3. Navigate to the Apps option on the left sidebar, open the Sites menu, and click Manage

    image-20260813-095822.png

  4. Navigate to Connected apps, find the QC Read & Understood for Confluence Cloud, and click Update.

You will be prompted to review and approve the updated Forge permissions required for the new platform architecture. Once you accept the permissions and confirm, the update will finish automatically, and all of your existing data and settings will stay completely intact, with no additional configuration needed.

Upgrade Timeline

According to Atlassian’s Connect End of Support timeline, Atlassian is phasing out the Connect framework over a multi-stage process, leading to full End of Support in Q4 2026. To stay ahead of these platform updates and avoid any disruption to your day-to-day process, we are completing our transition before Q4 2026, and we aim to officially release this new Forge version on September 07, 2026.

Please note that we will continue to maintain and support the current Connect version for as long as it remains in our hands to do so. However, no new features will be added to the Connect app, and Atlassian will eventually end platform support for it entirely. For these reasons, we strongly recommend that all customers update to the Forge version once it becomes available.

Once released, Site Administrators will be able to update the app directly from the Administration settings menu as mentioned in the “How to Complete the Upgrade” paragraph above.

Support

If you have any questions or concerns regarding this migration, we are here to help every step of the way.

You can reach out to our team directly from our Service Desk portal to submit a ticket, or schedule a 1-on-1 Zoom call with us to discuss your setup and address any questions you might have.

How to Contact Us