Setup & site building · Guide
How to Change the Background in WordPress (Step by Step)

Short answer
In a block theme, open Appearance, then Editor, then Styles, then Colors, and change the background color or image, then save. In a classic theme, open Appearance, then Customize, then Background Image or Colors, make your change and publish.
Key takeaways
- Check your theme type first: block themes use the Site Editor, classic themes use the Customizer.
- Global styles change the whole site; Group, Cover or builder sections change one area.
- If your theme has no background option, a short CSS rule on the body element works.
- Clear every cache layer if the new background does not appear.
- Keep text contrast high and background images compressed.
How do you change the background in WordPress?
You change the background in WordPress through the Site Editor's Styles panel in a block theme, or through Appearance, then Customize, then Background Image or Colors in a classic theme.
The exact screen depends on your theme type. Block themes and classic themes store design settings in different places, so the first job is to find out which kind you have.
After that, the change itself usually takes less than five minutes. You pick a color, gradient or image, preview it, and save.
This guide covers the whole site background, single page backgrounds, section backgrounds, and the CSS route for when your theme gives you no option at all.
How do you know if you have a block theme or a classic theme?
Go to Appearance in your dashboard: if you see an Editor item, you have a block theme, and if you see Customize with no Editor, you have a classic theme.
Block themes such as Twenty Twenty-Four and Twenty Twenty-Five use the Site Editor for everything, including colors and backgrounds. You can read more about how they work in our guide on what a block theme is.
Classic themes like Astra, OceanWP and older default themes use the Customizer. Many of them add their own background panels, so the labels may differ a little from what you see here.
Some hybrid themes show both menus. In that case, check the theme's own documentation to see which screen controls the background.
| Theme type | Where the background lives | Saved in |
|---|---|---|
| Block theme | Appearance > Editor > Styles > Colors | Global styles (database) |
| Classic theme with background support | Appearance > Customize > Background Image or Colors | Theme mods (database) |
| Page builder layouts | Section or container style settings | Post meta for that page |
| Any theme | Additional CSS or a child theme | Stylesheet |
How do you change the background color in a block theme?
Open Appearance, then Editor, click Styles, choose Colors, and change the Background color under the Elements or Color section, then click Save.
Here are the steps in order:
- In the dashboard, go to Appearance, then Editor.
- Click Styles in the left panel, then click the pencil or edit icon to open the Styles sidebar.
- Choose Colors.
- Click Background and pick a color from the palette, or enter a custom hex code.
- Watch the preview update, then click Save at the top.
The new color applies to the whole site because it is saved as a global style. The official Styles overview explains how global styles cascade down to every template.
If you want a quick full redesign rather than a single color, look at the Browse styles option. Many block themes ship with style variations that change background, text and accent colors together.
Can you add a background image in a block theme?
Yes, recent WordPress versions let you add a background image to the whole site from Styles, then Background, if your theme supports it.
Open the Styles sidebar and look for a Background or Layout section. If it is there, you can upload an image, set it to cover or contain, and choose whether it repeats.
If your theme does not show that option, the theme author has not enabled it in theme.json. You can turn it on yourself with a child theme, which our guide on using theme.json explains in detail.
The developer handbook on global settings and styles lists the settings that control which design tools appear in the editor.
A simpler workaround is the Cover block. Place a Cover block at the top of a template, set an image, and put your content inside it. You get a full-width background without touching code.
How do you change the background in a classic theme?
Go to Appearance, then Customize, and open Background Image or Colors, where you can upload an image or pick a background color, then click Publish.
The steps look like this:
- Go to Appearance, then Customize.
- Look for Colors, Background Image or a theme-specific panel such as Global or Design.
- Pick a background color or click Select image to upload one.
- Set the position, size, repeat and scroll options.
- Click Publish to make the change live.
These panels exist because the theme declared support for the custom background feature. The developer handbook page on custom backgrounds shows how themes switch it on.
If you do not see any background panel, your theme simply did not add support. You can still change the background with CSS, which we cover below.
The Customizer documentation on WordPress.org explains the live preview and how to schedule or save drafts of changes.
What do the background image options mean?
The image options control how the picture fills the screen: size decides scaling, repeat decides tiling, position sets the anchor point, and attachment decides whether it scrolls.
Here is what each one does in plain terms:
- Size: Cover stretches the image to fill the whole area and crops the edges. This is the usual choice for photos.
- Size: Contain shows the whole image, which can leave empty space at the sides.
- Repeat tiles a small image across the page. It works well for subtle patterns and textures.
- Position sets which part of the image stays visible, such as center or top left.
- Fixed or scroll decides whether the image stays still while content moves over it.
These map directly to CSS properties. The MDN reference for the CSS background property is a good place to see every value and what it looks like.
Fixed backgrounds look nice on desktop but often behave oddly on phones. Test on a real mobile device before you commit to that setting.
How do you change the background of one page only?
To change a single page, wrap its content in a Group or Cover block and set that block's background, or give the page a custom template with its own background.
The Group block method is the easiest. Select all blocks on the page, group them, then use the block's Color settings to set a background color or gradient.
If you want edge-to-edge color, set the Group block to full width. Otherwise the color stops at the content width and the site background shows at the sides.
In a block theme, you can also create a custom page template in the Site Editor and assign it to just that page. This keeps the main styles untouched.
On a classic theme, every page gets a unique body class such as page-id-42. You can target that class in CSS to change one page without affecting the rest.
How do you change a section background with Elementor or another builder?
In Elementor, select the section or container, open the Style tab, go to Background, and choose classic, gradient, video or slideshow.
Page builders handle backgrounds per section, not per site. That gives you a lot of control, but it also means the site-wide theme background can still show around your sections.
Our full walkthrough of Elementor background settings covers overlays, gradients and background video in detail.
Other builders such as Beaver Builder, Divi and Bricks follow the same idea. Look for a Style or Design tab on the row or section, then a Background option.
How do you change the background with CSS?
Add a CSS rule for the body element in Appearance, then Customize, then Additional CSS, or in the Styles panel's Additional CSS area in a block theme.
A basic example that sets a color looks like this:
body {
background-color: #f6f4ef;
}
To use an image instead, point to the image URL from your Media Library:
body {
background-image: url("https://example.com/wp-content/uploads/2026/01/texture.jpg");
background-size: cover;
background-attachment: fixed;
}
If the color does not appear, your theme may set a background on a wrapper element, not the body. Right-click the page, choose Inspect, and find the element that holds the color. Then target that selector instead.
For bigger design changes, put your CSS in a child theme. This keeps your changes safe when the parent theme updates.
Why is your new background not showing?
A new background usually fails to show because of caching, a page builder or theme setting overriding it, or a CSS rule with higher priority on another element.
Work through these checks in order:
- Clear your cache. Clear your caching plugin, server cache and browser cache. Our guide to clearing cache in WordPress covers each layer.
- Check for overrides. A full-width Group block, Cover block or builder section can cover the site background completely.
- Check the theme panel. Some themes have separate background settings for boxed and full-width layouts.
- Inspect the CSS. Use your browser's developer tools to see which rule wins, and whether yours is crossed out.
- Check the image. Make sure the image URL loads on its own and is not blocked by hotlink protection.
If none of that helps, switch briefly to a default theme on a staging copy. If the background works there, the issue is in your theme or a plugin.
What makes a good WordPress background?
A good background keeps text easy to read, loads quickly, and supports the content rather than competing with it.
Contrast matters most. Dark text on a light background, or the reverse, should meet the contrast levels in the WCAG contrast guidance so all visitors can read your pages.
Keep background images small. Compress them, use modern formats like WebP, and avoid huge photos behind long articles. A heavy background slows every page on the site.
Busy photos behind text are hard to read. If you must use one, add a dark or light overlay so the words stand out.
Finally, check the result on a phone. Most visitors arrive on mobile, and a background that looks calm on a wide screen can feel cramped on a small one.
If you plan bigger visual changes later, it may be worth reading about how to change a WordPress theme safely, since a new theme resets most background settings.
Frequently asked questions
Why is there no Background option in my Customizer?
The Background Image panel only appears when your theme declares support for custom backgrounds. Many themes skip it or move it into their own design panel. If you cannot find it anywhere, add a CSS rule for the body element under Additional CSS instead.
Can I use a video as my WordPress background?
Yes, but usually per section rather than site-wide. The Cover block accepts a video file, and page builders like Elementor offer video backgrounds on sections. Keep videos short and muted, and provide a fallback image, because video backgrounds add weight and may not autoplay on every phone.
Will changing my theme reset the background?
Usually yes. Background settings are stored as theme settings or global styles tied to the active theme, so a new theme starts with its own defaults. Note your colors and image URLs before switching so you can apply them again in the new theme.
How do I make the background different on mobile?
Use a CSS media query that targets small screens and sets a different color or image. Many themes and builders also offer responsive background controls, letting you pick a separate image for tablet and mobile views without writing code.
What size should a background image be?
For a full-screen photo, around 1920 pixels wide is usually enough, compressed to well under 300 KB where possible. Small repeating patterns can be tiny. Always compress the file and prefer WebP or AVIF so the background does not slow the page.
Sources
- Styles overview WordPress.org
- Customizer WordPress.org
- Custom Backgrounds WordPress Developer Resources
- Global Settings and Styles WordPress Developer Resources
- background MDN Web Docs
- Understanding Contrast (Minimum) W3C
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


