Custom Folder Icon

icon badge badge custom folder icon plugin custom folder icon custom folder icon plugin

Introduction

This plugin extends the Folders Plugin to to provide custom icons for folders. You can upload your own images or use the combined build status of the jobs within a folder as icon.

Changelog

Release notes are recorded in GitHub Releases.

Version 2.x

This version requires Jenkins 2.357 and above in order to support the transition to Java 11.

Version 2.x introduces a new type of icon. The BuildStatusFolderIcon displays the combined build status of the jobs within a folder.

Version 1.x

Since 2.1044 of the branch-api-plugin the Custom Folder Icons Plugin can be used for Multi-Branch or Organization Projects.

Configuration

Folder Configuration

There are two types of custom icons provided by this plugin.

overview

Custom Folder Icon

Use your custom icon for a folder.

custom folder icon

Select the Custom Folder Icon option and use "Browse…​" to chose a file.

You can crop the image to the desired result and upload it using the "Apply" button.

The file name will be randomized during upload.

custom folder icon configuration

Build Status Folder Icon

See the combined build status of the jobs within a folder.

build status folder icon

Select the Build Status Folder Icon option to use the combined build status of the jobs within a folder as icon.

build status folder icon configuration

Global Configuration

Check for unused custom folder icon files and delete them. This operation will delete all images that are currently not used by any folder configuration.

global configuration