smallImage icon not displaying in ArcGIS Pro Add-in (only blue circle shown)

[rdc_hirohara]

Hello,

I’m developing an ArcGIS Pro add-in using the Pro SDK (version 3.4), and I’ve run into an issue where the smallImage icon is not displaying as expected.

In my Config.daml, I’ve defined a button like this

<button id="MyAddin_MyButton" caption="My Button"
className="MyButtonClass"
loadOnClick="true"
smallImage="Images/AddInDesktop16.png"
largeImage="Images/AddInDesktop32.png">
</button>

I'm using the default AddInDesktop16.png that is automatically generated when creating a ProWindow in Visual Studio 2022.
However, when ArcGIS Pro's ribbon resizes (e.g., when the window is narrowed), instead of displaying the small icon, it shows a blue placeholder circle.

Here’s what I’ve already confirmed:

・AddInDesktop16.png is exactly 16×16 pixels.

・Build Action is set to Resource.

・"Copy to Output Directory" is set to Do not copy.

・The image is placed in an Images folder inside the project.

・It is referenced in the .daml using a relative path: "Images/AddInDesktop16.png".

Even when replacing it with a plain red square, the issue persists — so I suspect it’s not an image visibility or transparency issue.

My development environment is as follows:

・ArcGIS Pro 3.4

・Visual Studio 2022

・.NET 8

Is there something else I need to configure, or is this a known issue in 3.4? Any insight would be appreciated!

[SumitMishra_016]

Have you added smallImage="SdcxAdd16" and largeImage="SdcxAdd32" in the config.daml file?

<button id="id" keytip="B1" caption="Addin" className="Show" loadOnClick="true" smallImage="SdcxAdd16" largeImage="SdcxAdd32">
  <tooltip heading="tooltip"><disabledText /></tooltip>
</button>

Also, can you update to ArcGIS Pro 3.5 and check?

[rdc_hirohara]

Thank you very much for your reply.
I tried your suggestion, but unfortunately the small image still doesn't appear.

Currently, I’m developing under ArcGIS Pro 3.4, as specified by the client, so updating to 3.5 might not be possible right away. However, I’ll share this information with them and discuss whether an update is feasible — especially if it might resolve the issue.

I truly appreciate your support!

[SumitMishra_016]

Hi @rdc_hirohara ,

I actually faced a similar issue in a lower version of ArcGIS Pro, and it was resolved after updating to current version 3.5.

[RichardDaniels]

In Visual Studio 2022 check the properties for the file in your Solution Explorer. Should look like this:

[rdc_hirohara]

Thank you for your reply!
Yes, I already tried setting the Build Action to “Content” and “Do not copy” as you suggested, but unfortunately the issue still persists — the smallImage is not being displayed and is replaced with the default blue circle.
I appreciate your help and am still trying to find a reliable solution, especially since I’m restricted to using ArcGIS Pro 3.4 for this project.

Thanks again!

[CarlosDugarte]

T

[Rahul_Chahel · Accepted solution]

This could be due to the group not having an icon defined. When the ribbon resizes, ArcGIS Pro may show only the group icon and hide individual button icons. If no group icon is set, it might display a default placeholder like the blue circle you're seeing.

Try adding an icon to the group in your daml and see if that resolves it. Let me know if you want help with that!

[rdc_hirohara]

I followed your advice and added smallImage to the group — and it worked! Thank you so much!