The expected minimum image size for custom logo is: 112 x 96, 8-bit/colour RGBA, non-interlaced.
File formats accepted are: SVG, PNG, JPG.SVG, by their nature, should provide the best looking image, regardless of screen resolution: https://www.w3schools.com/graphics/svg\_intro.asp
At this time, the macOS Menu Bar or Windows System Tray Icon requires an additional Fileset. Details included below.
Note: For iOS/iPad, you will not see an entry in Fileset Status tab for the Kiosk Policy. After deployment, look under Client Info > Policies tab, and verify that the Kiosk Policy displays "true" in the Active column. If customizations do not display, force quit the Filewave Kiosk app and re-open to initiate the policy.
[](https://kb.filewave.com/uploads/images/gallery/2026-05/J7vSMURs0mIblSFt-image.png) #### Example Customisation Options Displayed in the below image: - Logo [](https://kb.filewave.com/uploads/images/gallery/2025-02/PzSG5SxfPZDfnFcQ-image.png) - Primary Colour: Green [](https://kb.filewave.com/uploads/images/gallery/2025-02/QxlGpmYo4U6ejWnH-image.png)The Menu Bar Extra Icon will show in black or white alone.
macOS may automatically hide one or more Menu Bar Extras to prevent crowding of the Menu Bar.
[FileWave Kiosk2 Menu Bar Icon.fileset.zip](https://kb.filewave.com/attachments/352) The Fileset needs to be edited prior to deployment. Out of the two files shown, the chosen custom image should be named to match the first png: 'tray-icon-macos.png'. Leave the other file in place. [](https://kb.filewave.com/uploads/images/gallery/2024-05/9RnVuVUgfWt1JLlN-image.png) Dragging the custom icon over the shown file should prompt a message as below. Select Replace. [](https://kb.filewave.com/uploads/images/gallery/2024-05/amQ1bWqAPhoSNJH6-image.png) Associate with a test device, and once happy with the look, you can broaden the association. The Fileset is designed to: - Restart the Kiosk after activation, automatically ensuring the user is immediately presented with the new logo - On de-activation, the '`tray-icon-macos.png.fw`' file will be copied to replace the custom logo (resetting the default) and again restarting the Kiosk for immediate change.Unlike the other images, the Windows System Tray is using '.ico' files. These need to be of equal size, e.g. 256x256, 128x128, etc.
Consider exporting the current 'ico' files, editing them with the chosen logo and then upload, if unsure how to create '.ico' files.
FileWave 15.4- (FileWave Client 32bit) [](https://kb.filewave.com/uploads/images/gallery/2025-01/be4WbIYnjD538Xx5-image.png) FileWave 15.5+ (FileWave Client 64bit) [](https://kb.filewave.com/uploads/images/gallery/2025-01/tkVOwySFCUUalzW9-image.png) Dragging the custom icon over the shown files should prompt a message as below. Select Replace. [](https://kb.filewave.com/uploads/images/gallery/2024-05/5YtOwr6I4T9tOVZa-image.png) Associate the relevant revision with a test device and once happy broaden the association.The new image will not show until the FileWave Client is restarted or the user logs out and back in.
If you are a [Hosted Customer](https://kb.filewave.com/books/community-engagement/page/cloud-hosting-product-information "Cloud Hosting Product Information") then you will need [Technical Support](https://kb.filewave.com/books/community-engagement/page/customer-technical-support "Customer Technical Support") to assist with these changes for now.
Direct editing of the IPA is not feasible. As such, the logo needs to be hosted from the FileWave Server. The chosen image needs to be placed in the following location: `/usr/local/filewave/django/static/kiosk2/images/` For the IPA to utilise this image, edit the the following file: `/usr/local/filewave/django/filewave/settings_custom.py` The line may be added to the bottom of the custom settings file and needs to include the FQDN of the FileWave Server, along with the named image in the format: *KIOSK\_LOGO\_URL = 'https://\[fully\_qualified\_domain\_name\]/filewave/static/kiosk2/images/\[file name\]'* For example, imagine those details are: - image.svg - demo.filewave.ch The line added will then appear as: `KIOSK_LOGO_URL = 'https://demo.filewave.ch/filewave/static/kiosk2/images/image.svg'` Supported file formats are: ``` - SVG - JPEG - PNG - GIF - Animated GIF - WebP - Animated WebP - BMP - WBMP ``` ### Customise Colour Colour may be customised by editing the same custom settings file. The colour should be presented in hex of either 6 or 8 characters. The line to add (again this may be added to the bottom of the custom settings file), should be of the format: *KIOSK\_PRIMARY\_COLOR = '\[hex colour\]'* For example: ``` KIOSK_PRIMARY_COLOR = '#e580ff' ``` or ``` KIOSK_PRIMARY_COLOR = '#FF0000CC' ```The FileWave Server Service should be restarted after modification of the custom settings python file.
| **Key Name** | **Key Value** | **Default** |
| logo\_url | URL path to hosted custom image | FileWave Logo |
| primary\_color | Colour in hex format, e.g. #RRGGBB | \#0465DA |
| kiosk\_app\_name | Text Name of opened Kiosk Window | FileWave Kiosk |
It may be necessary to reboot the computer or log out and back in, before changes take effect; particularly if customisation of the older Version 1 Kiosk was removed at the same time that the new Version 2 Kiosk and customisation is applied.
If the custom icon is added as per the instructions for i(Pad)OS devices, the same URL may be used in the above settings.
#### macOS Menu Bar Extra Icon The following method provides a pre-configured Fileset for customising this icon with a local file.The Menu Bar Extra Icon will show in black or white alone.
macOS will automatically hide one or more Menu Bar Extras to prevent crowding of the Menu Bar.
[FileWave Kiosk2 Menu Bar Icon.fileset.zip](https://kb.filewave.com/attachments/352) The Fileset needs to be edited prior to deployment. Out of the two files shown, the chosen custom image should be named to match the first png: 'tray-icon-macos.png'. Leave the other file in place. [](https://kb.filewave.com/uploads/images/gallery/2024-05/9RnVuVUgfWt1JLlN-image.png) Dragging the custom icon over the shown file should prompt a message as below. Select Replace. [](https://kb.filewave.com/uploads/images/gallery/2024-05/amQ1bWqAPhoSNJH6-image.png) Associate with a test device, and once happy with the look, you can broaden the association. The Fileset is designed to: - Restart the Kiosk after activation, automatically ensuring the user is immediately presented with the new logo - On de-activation, the '`tray-icon-macos.png.fw`' file will be copied to replace the custom logo (resetting the default) and again restarting the Kiosk for immediate change.| **Key Name** | **Key Value** | **Default** |
| logo\_url | URL path to hosted custom image | FileWave Logo |
| primary\_color | Colour in hex format, e.g. #RRGGBB | \#0465DA |
| kiosk\_app\_name | Text Name of opened Kiosk Window | FileWave Kiosk |
It may be necessary to reboot the computer before changes take effect; particularly if customisation of the older Kiosk was removed at the same time that the new Kiosk and customisation is added.
If the custom icon is added as per the instructions for i(Pad)OS devices, the same URL may be used in the above settings.
#### Windows System Tray Icon The following method provides a pre-configured Fileset for customising this icon with a local file. [FileWave Kiosk2 Sytem Tray Icon.fileset.zip](https://kb.filewave.com/attachments/427) The provided Fileset contains two revisions: - FileWave Client version 15.4- (32bit FileWave Client) - FileWave Client version 15.5+ (64bit FileWave Client) [](https://kb.filewave.com/uploads/images/gallery/2024-08/ZolzIDi5VqyuYZ1O-image.png) The Fileset needs to be edited prior to deployment. Out of the four files shown, the chosen custom icon should be named to match the two icon files: 'tray-icon-dark.ico' and 'tray-icon-light.ico'. Leave the other two files in place.Unlike the other images, the Windows System Tray is using '.ico' files. These need to be of equal size, e.g. 256x256, 128x128, etc.
Consider exporting the current 'ico' files, editing them with the chosen logo and then upload, if unsure how to create '.ico' files.
FileWave 15.4- (FileWave Client 32bit) [](https://kb.filewave.com/uploads/images/gallery/2025-01/be4WbIYnjD538Xx5-image.png) FileWave 15.5+ (FileWave Client 64bit) [](https://kb.filewave.com/uploads/images/gallery/2025-01/tkVOwySFCUUalzW9-image.png) Dragging the custom icon over the shown files should prompt a message as below. Select Replace. [](https://kb.filewave.com/uploads/images/gallery/2024-05/5YtOwr6I4T9tOVZa-image.png) Associate the relevant revision with a test device and once happy broaden the association.The new image will not show until the FileWave Client is restarted or the user logs out and back in.