LogoLogo
MainsailMainsailOSCrowsnest
  • Welcome to Mainsail
  • Setup
    • Installation
      • MainsailOS
      • KIAUH
      • Docker
      • Manual setup
      • my.mainsail.xyz
    • Updates
      • Update Manager
      • Manual Update
    • Configuration
  • overview
    • Features
      • Bed Mesh
      • Console
      • Dashboard Organisation
      • Exclude Objects
      • Hide macros, outputs or fans
      • Localization
      • Macro Management
      • Macro Prompts
      • Presets
      • Print History and Statistics
      • Query devices
      • Built-in Themes
      • Custom Themes
        • Prepare
        • Backgrounds
        • Logos and Icons
        • Custom Navigation
        • Custom CSS
        • Community Themes
      • Thumbnails
      • Webcam
    • Settings
      • General
      • Console
      • Control
      • Dashboard
      • Editor
      • G-Code Viewer
      • Macros
      • Presets
      • Printers
      • UI-Settings
      • Webcams
    • Slicer
      • Cura
      • Ideamaker
      • PrusaSlicer
      • SuperSlicer
    • Quicktips
      • Slicer upload
      • Remote Access
      • Printer power switch
      • Additional Sensors
      • Disable Octoprint LCD menu
      • config.json
  • FAQ
    • Mainsail
    • Klipper warnings
      • Deprecated Values
      • Deprecated Options
      • Runtime Warning
    • Moonraker warnings
      • PolicyKit Permissions
    • Klipper errors
      • MCU Protocol error
    • Mainsail errors
      • Unauthorized
    • Getting Help
      • Discord
      • GitHub Discussions
  • About
    • Data Privacy
    • Sponsors
    • Development
      • Code standards
      • Contribute
      • Environment
      • Localization
    • Credits
  • 🔗Links
    • Github
    • Release Notes
    • Discord
    • Youtube
Powered by GitBook
On this page
  • Sidebar background image
  • Main background image

Was this helpful?

Edit on GitHub
  1. overview
  2. Features
  3. Custom Themes

Backgrounds

Place some background images to give Mainsail its own look with ease.

PreviousPrepareNextLogos and Icons

Last updated 2 years ago

Was this helpful?

There are two background images that can be used in Mainsail. The first is in the sidebar and the second is in the main section.

You can upload a new background image using the file manager located in Settings > Machine.

Sidebar background image

Load the background image into your .theme folder and name it sidebar-background.<extension>.

Filename
sidebar-background

Valid file extensions

.jpg, .png, .gif and .svg

Recommended image size

300x1000px

Main background image

Upload a background image into your .theme folder and name it main-background.<extension>.

Filename
main-background

Valid file extensions

.jpg, .png, .gif and .svg

Please note: The background image is stretched to cover the entire area by default. For example, if you want a repeating pattern, you will also need to use custom CSS to style it correctly.