How can a Marketplace app display a Flag outside its own UI?

Forge Forge Platform and Tools
1

Hi everyone,

I’m trying to understand how this is technically possible.

I’ve noticed that some Marketplace apps are able to display an Atlassian Flag notification while the user is on a Jira page that doesn’t belong to that app (for example, a native Jira page or another app’s page).

imagen
imagen824×1788 113 KB

As far as I understood, an app should only be able to interact with the UI inside the modules it owns.

So my question is:

  • How can an app trigger a Flag when the user is not currently viewing one of its own pages?
  • Is there an official API or mechanism for showing global Flags across Jira?
  • Or is this only possible under specific module types or extension points?

I’d appreciate any guidance or documentation that explains how this works.

Thanks!

2

Hi @laura.barreales :waving_hand:t2:

I think what you are looking for is showFlag() from @forge/bridge:

3

You may not use the appearance property as It’s quite buggy in my opinion or I just didn’t use it correctly

  • You can’t close a flag if you show a second one (maybe because I didn’t use a unique Id)
  • If you navigate to another issue, you are also not able to close the flag (maybe you would need to register a page unload handler)
4

Hello,
You can check this: https://developer.atlassian.com/platform/forge/in-app-notifications-from-events/

tldr; You can use background scripts to display flags outside of our visible ui modules.