In my years of developing desktop applications with Python, I’ve found that the default gray look of Tkinter can be a bit dull.
One of the first things I usually do to make an interface pop is adjust the frame background colors.
It is a simple change, but it makes a massive difference in how professional your application looks to your users.
In this tutorial, I will show you exactly how to change the background color of a Tkinter frame using several different methods.
The Basic Way to Change Frame Background Color
When I first started using Tkinter, I realized that the Frame widget is essentially a container.
To change its color, you simply use the bg (or background) attribute during the initialization of the widget.
Here is a practical example. Let’s say we are building a simple dashboard for a California-based real estate firm to track property listings.
import tkinter as tk
# Initialize the main window
root = tk.Tk()
root.title("California Real Estate Dashboard")
root.geometry("500x300")
# Creating a frame with a specific background color
# I am using 'hex codes' for a professional look
top_frame = tk.Frame(root, bg="#2c3e50", height=100, width=480)
top_frame.pack(pady=20)
# Adding a label to the frame
label = tk.Label(top_frame, text="Luxury Listings - Los Angeles", bg="#2c3e50", fg="white")
label.pack(padx=20, pady=20)
root.mainloop()You can see the output in the screenshot below.
In this code, I used a hex color code (#2c3e50), which is a deep navy blue. I find that using hex codes gives me much more control than just typing “blue” or “red.”
Change Background Color Using the .config() Method
Sometimes, you might want to change the color of a frame dynamically while the program is running.
I often use this technique in US-based fintech apps to indicate a change in status, like a stock price going up or down.
Instead of setting the color at the start, you can use the .config() method later in your code.
import tkinter as tk
def change_status():
# Updating the background color dynamically
status_frame.config(bg="#27ae60") # Changes to green
status_label.config(text="Market Open - Wall Street", bg="#27ae60")
root = tk.Tk()
root.title("NYSE Market Monitor")
root.geometry("400x200")
status_frame = tk.Frame(root, bg="#e74c3c", height=100, width=350) # Starts Red
status_frame.pack(pady=30)
status_label = tk.Label(status_frame, text="Market Closed", bg="#e74c3c", fg="white")
status_label.pack(pady=10)
btn = tk.Button(root, text="Check Market Status", command=change_status)
btn.pack()
root.mainloop()You can see the output in the screenshot below.
I’ve used this many times when I need a “flash” effect or a visual cue for the user that an action has been completed.
Use System-Specific Colors for a Native Look
If you are designing an app specifically for Windows or macOS users in the States, you might want the background to match the system theme.
Tkinter allows you to use system-defined color names like SystemButtonFace or SystemWindow.
In my experience, this is the best way to make your app feel like a native part of the operating system rather than a third-party tool.
import tkinter as tk
root = tk.Tk()
root.title("Native Windows App Look")
# Using system colors
native_frame = tk.Frame(root, bg="SystemButtonFace", width=300, height=200)
native_frame.pack(padx=10, pady=10)
root.mainloop()While this isn’t “exciting,” it provides a very clean and consistent user experience for corporate tools.
Use the Canvas Widget for Gradient Backgrounds
Standard Tkinter frames do not support gradients natively, which can be frustrating if you want a modern UI.
When I need a gradient background for a high-end application, like a premium New York fashion brand’s inventory tool, I use a Canvas widget inside the frame.
You can draw multiple rectangles of slightly different shades to simulate a smooth color transition.
import tkinter as tk
def create_gradient(canvas, color1, color2):
# Get canvas height
height = 200
width = 400
# Calculate color increments
# This is a simplified logic for demonstration
for i in range(height):
# Logic to blend color1 to color2
# For simplicity, we will alternate two colors
color = color1 if i < 100 else color2
canvas.create_line(0, i, width, i, fill=color)
root = tk.Tk()
root.title("Gradient Background Example")
main_frame = tk.Frame(root, width=400, height=200)
main_frame.pack()
canvas = tk.Canvas(main_frame, width=400, height=200)
canvas.pack()
# Simulating a basic split gradient
create_gradient(canvas, "#3498db", "#2980b9")
root.mainloop()You can see the output in the screenshot below.
This method takes a bit more effort, but the visual result is far superior to a flat, solid color.
Set Background Colors via Options Database
If you have a large application with dozens of frames, setting the background color for each one individually is a headache.
I prefer using the option_add method to set a “global” theme for all frames in the application at once.
This is a huge time-saver when you are working on large-scale projects for US government agencies or educational institutions.
import tkinter as tk
root = tk.Tk()
root.title("Global Theme Configuration")
# This sets the background for EVERY Frame widget created hereafter
root.option_add("*Frame.background", "#f1c40f") # Sunflower Yellow
frame1 = tk.Frame(root, width=100, height=100)
frame1.pack(side="left", padx=10)
frame2 = tk.Frame(root, width=100, height=100)
frame2.pack(side="left", padx=10)
root.mainloop()I’ve found this to be the most efficient way to maintain brand consistency across multiple windows and dialog boxes.
Common Issues When Changing Frame Colors
One thing that often trips up developers is when the frame background doesn’t seem to show up.
Usually, this happens because the frame is empty and has shrunk to 0x0 pixels.
I always recommend adding a bit of padx and pady, or explicitly setting the width and height (and using pack_propagate(0)) to ensure the color is visible.
Another issue is the border. If you see a tiny gray line around your colored frame, it’s the highlight thickness.
You can remove this by setting highlightthickness=0 and borderwidth=0.
Final Thoughts
Changing the background color of a Tkinter frame is a fundamental skill for any Python developer.
Whether you use simple color names, professional hex codes, or global theme settings, you can create much more engaging software.
You may also like to read:
- How to Change the Tkinter Title Bar Color
- Python Tkinter vs PyQt
- How to Copy Text to Clipboard in Python Tkinter
- How to Align Widgets to the Left in Tkinter Grid
I am Bijay Kumar, a Microsoft MVP in SharePoint. Apart from SharePoint, I started working on Python, Machine learning, and artificial intelligence for the last 5 years. During this time I got expertise in various Python libraries also like Tkinter, Pandas, NumPy, Turtle, Django, Matplotlib, Tensorflow, Scipy, Scikit-Learn, etc… for various clients in the United States, Canada, the United Kingdom, Australia, New Zealand, etc. Check out my profile.
