Sp-dev-docs: How to change the spapp icon ?

Created on 31 Aug 2016 · 11Comments · Source: SharePoint/sp-dev-docs

Is it possible to change the default icon for the generated App SharePoint ? Is there an existing setting in the package-solution.json file ?

tooling tracked uservoice-request

Source

OlivierCC

Most helpful comment

In order to change the icon on the tile, you should do the following:

On config/package-solution.json you can add:
{ "solution": { ... "iconPath": "a/path/to/the/icon.png", ... } ... }

The icon path is the relative path on the sppkg. You can drop the icon in /sharepoint/ folder for that (assume /sharepoint/ is the root folder, for all purposes).
Note that this affects only the tile in site contents, but not the icon of the web part in the toolbox.

mpasarin on 3 May 2017

👍3

All 11 comments

Yes - take a look at the officeFabricIconFontName property in your webpart.manifest.json file.

patmill on 31 Aug 2016

Take a look at @waldekmastykarz article here for even more details https://blog.mastykarz.nl/specify-icon-sharepoint-framework-client-side-web-part/

weshackett on 31 Aug 2016

👍1

Thanks for your answer. I seen the excellent blog post from @waldekmastykarz but in fact i'm looking for a method to change the icon of the SPAPP that appears on the "Site contents" screen or in the App catalog, as show in the following attached capture.
spapp icon

OlivierCC on 31 Aug 2016

👍1

Those can normally be set be editing the entry in the app catalog apps for sharepoint list. Not tried for an spfx app package but it goes into the same place so might work.

weshackett on 1 Sep 2016

Hi Wes, yes you're right, I can change the icon of the App in the App Catalog. I tested with a SPFx App and it's working too (see the following screenshots).
spappicon
spappicon2

But the problem is that I can also built SPAPP to distribute it in the Office Store, and I don't want to have to ask to each SP Admin to modify the icon.

In the old SharePoint App built with Visual Studio, we have got a Icon property in the App Manifest (see following screenshot).

spappicon3

My suggestion is to integrate a icon property in the package-solution.json file, to integrate it the generated App manifest. Do you know if it's possible or plan in a next release ? Thanks

OlivierCC on 1 Sep 2016

👍1

VSO #243419

manishgarg1 on 1 Sep 2016

In order to change the icon on the tile, you should do the following:

On config/package-solution.json you can add:
{ "solution": { ... "iconPath": "a/path/to/the/icon.png", ... } ... }

mpasarin on 3 May 2017

👍3

It does not work for me. An icon is included into a package but after uploading the app into AppCatalog, it is not recognized as an app: no errors, but SharePoint cannot find web parts, determine its version and does not allow to deploy it.

jusper-dk on 16 May 2017

This needs to be documented here: https://dev.office.com/sharepoint/docs/spfx/web-parts/basics/notes-on-solution-packaging

Also, anyone had any luck getting this working - or any luck pre-setting the app description text as well?

shaipetel on 16 May 2017

👍1

I'm at the same siguation as @jusper-dk . The image (a png file) is in the package, and referenced correctly it seems. If I mis-spell it or the file doesn't exist, the build fails.
So, it seems it is done correctly and the image went into the package.

However, SherePoint seems to keep loading the default icon.
Setting the icon and description is VERY important to my product manager...

shaipetel on 16 May 2017

Issues that have been closed & had no follow-up activity for at least 7 days are automatically locked. Please refer to our wiki for more details, including how to remediate this action if you feel this was done prematurely or in error: Issue List: Our approach to locked issues