jira:globalPage pages icons not visible

Forge Forge UI Kit and Custom UI
, ,
1

Problem

  • Icons defined using resource: are not displayed.

  • External URL icons (e.g. https://...) also don’t appear.

  • The pages themselves work correctly, only the icons are missing.

What I’ve tried

  • Verified that the icon files exist in the correct resources directory

  • Tried both .png and .svg formats

  • Used both local resource paths and external URLs

Question

Is there any limitation or specific requirement for icons in jira:globalPage.pages?
Are external URLs supported, or is there a required format/size for resource icons?

Any help or guidance would be appreciated :folded_hands:

Thanks!

its show like this

image
image285×104 2.95 KB

jira:globalPage:
  - key: forge-test-app
    resource: main
    resolver:
      endpoint: remote-macro-node
    title: Test App
    layout: blank
    icon: resource:icons;logo.png
    pages:
      - title: Dashboard
        icon: resource:icons;logo.svg
        route: /dashboard
      - title: Pulse
        icon: resource:icons;pulse.png
        route: /pulse
      - title: Settings
        icon: https://mysite.com/settings.png
        route: /settings

2

Hi @NikaKhvichia

If the icon is stored locally, it should be placed in the public/icons folder.

Also, make sure you run the build before testing or deploying/install –upgrade, and check that the icons folder is correctly copied into the dist folder afterward. If the folder is not present in dist, the app will not be able to load the local icon.

For HTTPS, I’m not completely sure since I don’t use it on my side. It might be related to the permissions or configuration in the manifest, but I can’t confirm that part.

1 Like
3

Hi @FlixAndre, thanks for the suggestions!

I’ve already done everything you mentioned — icons are in the public/icons folder, I ran the build, and confirmed the icons folder is correctly present in the dist directory after the build. Unfortunately the icons are still not showing up.

One thing I noticed though — are you using the jira:globalPage module or jira:adminPage? The reason I ask is that icons seem to work fine on jira:adminPage on my side, but they’re not rendering at all on jira:globalPage. I’m starting to think the issue might be specific to the globalPage module rather than the icon files themselves.

Have you ever tested icons on globalPage specifically? Would appreciate knowing if that’s the case for you too.

here is adminPage module: icons are there

image
image303×101 4.37 KB

4

You’re right,

that’s not working on jira:globalPage, it works only with jira:adminPage, weird behaviour !

5

Hi @FlixAndre

It looks like this is actually a known issue. I’ve found a bug already registered in the Atlassian ecosystem:

https://jira.atlassian.com/browse/ECO-1089

Could you please take a moment to vote for it? That might help get it prioritized.

Thanks!

6

Thanks, I add a vote ! :slight_smile: