How To Set Icon (On Dock/Taskbar) For JavaFX Application


Recently, I did some overhauls for my JavaFX application. The app has a default Java icon on Windows and Linux but for some reason, on my Mac, the icon is a folder.

I was OK with the default Java icon but no way I can accept it as shown as a folder on Mac.

So, I decided to find a way to set the icon for my app on Mac’s dock.

And it worked!

The code is quite simple though.

How to set the application icon for your JavaFX app

First of all, here is my folder structure:

JavaFX Application folder structure
JavaFX Application folder structure

As you can see, the icon.png file is under the images folder.

If you have a different structure, you need to adjust accordingly.

Here is the code snippet that displays your custom application icon:

import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.scene.image.Image;
import javafx.stage.Stage;

import java.awt.Taskbar;
import java.awt.Toolkit;
import java.awt.Taskbar.Feature;
//.. Other imports
public class Main extends Application {

    public void start(Stage primaryStage) throws Exception {
        Parent root = FXMLLoader.load(getClass().getResource("/ui/app_ui.fxml"));

        //Set icon on the application bar
        var appIcon = new Image("/images/icon.png");

        //Set icon on the taskbar/dock
        if (Taskbar.isTaskbarSupported()) {
            var taskbar = Taskbar.getTaskbar();

            if (taskbar.isSupported(Feature.ICON_IMAGE)) {
                final Toolkit defaultToolkit = Toolkit.getDefaultToolkit();
                var dockIcon = defaultToolkit.getImage(getClass().getResource("/images/icon.png"));


        primaryStage.setTitle("Excel Ultimate Search (ver. " + AppInfo.APP_VERSION + ")");
        primaryStage.setScene(new Scene(root));

There are two parts in the snippet above you need to use:

From line 6 to line 7, this snippet set the icon on the application header. Here is the icon on my app:

icon on the application title bar
icon on the application title bar

Theses two lines are enough if you use your app on Windows and Linux only.

However, if you also want to support MacOS, you will need 10 to 19.

Line 10 to line 19 do the task of setting the application icon on the MacOS’s dock.

icon on the taskbar-dock
the icon on the taskbar-dock


As you can see, it’s quite simple to set the application icon on the title bar and also on the taskbar/dock for your JavaFX application. My development environment uses Java 17 SDK but this should work on other versions too.

2 thoughts on “How To Set Icon (On Dock/Taskbar) For JavaFX Application”

Leave a Comment