On this page:

How to check if your site is ready for Forge

Once Didit runs fully on Atlassian Forge, Jira automation rules that start Didit by setting the didit.action issue property stop working: Forge apps aren’t notified when an issue property is set (Atlassian ticket FRGE-55).

The Forge readiness tab in the Didit admin settings shows whether your site still uses these rules. It’s for Jira administrators, in Jira only. Didit for Confluence isn’t affected. To see the tab, update Didit to the latest version 5.x.

Open the Forge readiness tab

  1. In Jira, open the Didit hub via Apps → Didit - Checklists and click Admin settings in the left navigation.

    Or go to Jira settings (⚙) → Apps and choose Didit - Checklists in the left sidebar.

    The Didit hub with the Admin settings entry in the left navigation highlighted.
    The Didit hub with the Admin settings entry in the left navigation highlighted.
  2. Open the Forge readiness tab.

    The Forge readiness tab in the Didit admin settings showing the Old trigger detected status, the last old-trigger run, the Check if you are all set box, and Impacted projects below it.
    The Forge readiness tab in the Didit admin settings showing the Old trigger detected status, the last old-trigger run, the Check if you are all set box, and Impacted projects below it.

What the status means

StatusWhat it meansWhat to do
Action neededYour last check found rules that still use the old trigger. The tab lists them by project.Migrate them as shown in How to migrate your automation rules to Forge, then check every rule again.
Ran after your checkYour last check was clean, but the old trigger ran after it.Find the rule in the project the tab names. It may be new, imported, or missing from the export. Migrate it, then check again.
Old trigger detectedNo check yet, and the old trigger ran in the last 30 days. The tab lists the projects it ran in.Follow How to migrate your automation rules to Forge, then check every rule.
Probably goodNo check yet, and the old trigger hasn’t run in the last 30 days.To be sure, check every rule. A rule that rarely runs or is turned off can still use the old trigger.
All goodYour last check found no rule that uses the old trigger, and it hasn’t run since.Nothing.

Check every rule

Give the tab an export of all your rules. It’s the only way to be 100% sure:

  1. In Jira settings (⚙), select System → Automation flows, then More actions (…) → Export flows. Click Next, then Done.

    See all rules in the tab’s Check if you’re all set box opens that page for you.

    Exporting all automation rules in Jira: More actions, then Export flows, Next, and Done, after which Jira downloads the JSON file.
    Exporting all automation rules in Jira: More actions, then Export flows, Next, and Done, after which Jira downloads the JSON file.
  2. In the Forge readiness tab, drop the file on Check if you’re all set, paste it there, or click Choose file.

    Didit lists every rule that still uses the old trigger, by project, removes projects without one from Impacted projects, and updates the status for your whole site. The box shows when the last check ran and who ran it. The list itself isn’t saved: check the file again to see it later.

    Pasting an export of all rules into Check if you are all set in the Forge readiness tab. The status turns to Action needed with 3 rules still on the old trigger, listed by project: one global rule and two rules in the KAN project, all to rebuild with Create checklist from template.
    Pasting an export of all rules into Check if you are all set in the Forge readiness tab. The status turns to Action needed with 3 rules still on the old trigger, listed by project: one global rule and two rules in the KAN project, all to rebuild with Create checklist from template.

Frequently asked questions

When does the tab turn to All good?
Does Didit store my automation rules?
A project came back to Impacted projects. Why?
The old trigger keeps running, but I can’t find any rule that sets didit.action. What now?
What does Unknown project mean?
Can I turn off an old rule instead of rebuilding it?
A rule just ran, but the tab doesn’t show it yet. Why?
The tab says “The Forge readiness check could not be loaded.” What should I do?

Need help getting your site ready? Reach out to our support team or chat with us.