Technical Anshu
Tutorials Blog
Ventoy Theme Guide

Ventoy Custom Theme and Wallpaper Setup Add Your Own Branding

Your Ventoy stick boots on customer PCs every day - it should look like yours. Custom wallpaper, your colours, your name on the menu: this guide sets up a complete Ventoy theme and branding, and tells you honestly what branding can and cannot change.

By Technical AnshuVentoy Theme Guide9 minute read
Watch the video for the live wallpaper and branding setup on a real Ventoy drive

The default Ventoy boot menu is functional, but it looks the same on every USB stick in the world. If this is your toolkit - the one you boot in front of customers every day - it should carry your wallpaper, your colours and your name. Ventoy is built on GRUB2, so its whole menu is themeable with files you control: a theme folder, one theme.txt and one settings file, ventoy.json. This guide sets all of it up end to end, and ends with the one honest limit every branding guide should tell you.

USB drive - data partition - folder layout
Ventoy USB (data partition) +-- ventoy | +-- ventoy.json | +-- theme | +-- mytheme | +-- theme.txt | +-- background.png | +-- Hack-14.pf2 +-- Win11_26H2.iso +-- StrelecPE.iso
The only folder Ventoy reads for settings is ventoy on the data partition - everything for your theme lives inside it
1

Understand the Three Pieces First

Every Ventoy customisation is just three things working together. The theme folder holds your wallpaper, fonts and the layout file. The file theme.txt inside it is a standard GRUB2 theme file - it names the background image, the title text and the menu colours. And ventoy.json, sitting in the ventoy folder on the data partition, is the settings file that tells Ventoy which theme to load. Change any one of the three and nothing happens until the other two agree with it - most theme problems are simply these three files pointing at different places.

2

Get a Theme or Build a Minimal One

You have two starting points. The easy one: Ventoy accepts any GRUB2 theme, and large collections of ready-made GRUB themes are shared on gnome-look.org - download one, and you get a complete folder with a theme.txt, images and fonts. The clean one: build a minimal theme yourself. Create a folder, put your wallpaper in it as background.png, and create a theme.txt with at least a desktop image line:

  1. desktop-image: "background.png" - the wallpaper, named exactly as the file
  2. desktop-color: "#000000" - the colour shown behind everything
  3. title-text: "Technical Anshu" - your name or shop name as the menu title

Make the wallpaper the same resolution you will set in step 4 - a 1920x1080 image for a 1920x1080 menu - so it is never stretched.

3

Copy the Theme onto the Drive

  1. Open the Ventoy drive's data partition (the large one with your ISO files, not the small 32 MB VTOYEFI partition)
  2. If there is no ventoy folder at its root, create one - the name must be exactly ventoy
  3. Inside it, create a theme folder and copy your whole theme folder in, for example ventoy/theme/mytheme/
  4. Check the result: theme.txt and the wallpaper must sit inside mytheme, not loose in theme
4

Point Ventoy at the Theme

Now tell Ventoy to use it. The official way is VentoyPlugson, the GUI configurator that ships with Ventoy: open it, go to the Theme Plugin section, and select your theme.txt. Plugson writes the settings file for you. If you prefer to edit by hand, ventoy.json needs a theme object like this:

  1. "file": "/ventoy/theme/mytheme/theme.txt" - a full path from the data partition root, forward slashes only
  2. "gfxmode": "1920x1080" - the menu resolution; the default is 1024x768, and "max" uses the highest the machine offers
  3. "display_mode": "GUI" - keep the graphical menu

Paths in ventoy.json must match your folder names exactly, letter for letter. One wrong folder name and Ventoy silently keeps the default theme.

ventoy.json - the complete theme block
{ "theme": { "file": "/ventoy/theme/mytheme/theme.txt", "gfxmode": "1920x1080", "display_mode": "GUI" } }
This is valid, copy-paste clean JSON - note the forward slashes and no comma after the last line
5

Boot, Check and Adjust

  1. Restart and boot from the USB - your wallpaper and title should appear with the menu
  2. Wrong colours or a stretched image? Your wallpaper resolution and gfxmode do not match - fix one of them
  3. Press F5 in the menu and open Tools - Theme Select (Ventoy 1.0.62 and later) to switch between installed themes on the spot - useful while comparing designs; the choice is temporary and is not saved
  4. Keep a copy of the finished ventoy folder on your PC - it is your whole customisation in one small backup
Honest note on branding: a theme changes looks only. It does not make Ventoy faster, does not add features and does not change which ISOs boot. And the small version text at the bottom-left corner of the menu (for example 1.0.10 UEFI www.ventoy.net) is hard-coded in Ventoy - you can move it and change its colour with ventoy_left, ventoy_top and ventoy_color, but no setting removes it. Any guide promising to delete it via settings is wrong.

Watch the Full Setup in the Video

The video walks through the wallpaper swap and branding on screen, step by step.

Watch Full Video
Frequently Asked Questions

Will a custom theme slow down the Ventoy boot menu?

No, not in any way you can feel. Ventoy loads one background image and a small layout file. A very large wallpaper (a multi-megabyte 4K PNG) can add a moment on very old machines, so size your image to your gfxmode resolution - 1920x1080 is plenty.

Can I use any GRUB2 theme I find online?

Yes. Ventoy is based on GRUB2 and its theme plugin loads standard GRUB2 themes - the big collections on gnome-look.org work. Copy the theme folder into ventoy/theme on the data partition and point the theme file setting at its theme.txt.

Will my theme survive a Ventoy update?

If you use the Update option, yes - update keeps the data partition, so your ventoy folder, theme and ISOs stay. If you run a fresh Install, the drive is formatted and the theme is wiped with everything else. Keep a backup copy of the ventoy folder either way.

This guide is based on the Ventoy Custom Wallpaper Setup video by Technical Anshu - Add Your Branding - Stuck on a step? Ask in the video comments, help is always there.