Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
Block Themes

How to Add a Background Image in WordPress (Block and Classic Themes)

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The right way to add a background image in WordPress depends on where you want it: use Appearance → Editor → Styles → Background for a block-theme site, a Cover block for one section, or Appearance → Customize → Background Image when a classic theme provides that control.

Choose the scope first

Goal Best route What it changes
Background across the site Appearance → Editor → Styles → Background (block themes) Overall site styling, subject to template and block backgrounds that may cover it
Image behind one section and its text Cover block Only the selected content area
Background in a classic theme Appearance → Customize → Background Image, if available Theme-defined background settings

A block’s own settings can override global Styles settings. Likewise, an opaque template or section background can hide a site-wide image in some areas.

Add a site-wide background in a block theme

Block themes use the Site Editor rather than the traditional Customizer for global design controls. WordPress documents these Styles background controls for block themes and WordPress 5.9 or later.

  1. In the WordPress dashboard, open Appearance → Editor.
  2. Open Styles, then select Background.
  3. Choose Image.
  4. Select an image from the Media Library or upload a file.
  5. Review the controls WordPress exposes for that theme, including position, sizing, repeat behavior, and fixed behavior where offered.
  6. Set the focal point when available so the important subject stays visible if the image is cropped.
  7. Save the site changes, then check the pages and templates where the image should appear.

These settings describe the site’s overall appearance, not a guarantee that every region will show the image. Headers, footers, templates, and individual blocks may have their own backgrounds.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Put an image behind one section with a Cover block

Use a Cover block when the image should sit behind a heading, paragraph, button, or other content in a defined area. WordPress describes Cover as a block for a background color, image, or video with a text overlay.

  1. Open the page or template in the editor.
  2. Insert a Cover block, or type /cover in the editor.
  3. Upload an image or choose one from the Media Library.
  4. Add or move your text and other blocks inside the Cover block.
  5. Use the toolbar and sidebar to adjust content position, minimum height, crop, and other controls available in your installation.
  6. Save or update the page, then preview it at the screen sizes your visitors use.

Cover is different from an Image block: the Cover block is designed for overlay content, while an Image block simply displays an image in the content flow. Its crop tool creates an edited image file while retaining the original in the Media Library.

Use a supported block’s own background setting

Some blocks expose a Background control under their Styles settings. Select the block, open the Styles tab in the sidebar, and choose the background image option if it is present. Support varies by block, theme, and WordPress version; a missing control does not indicate an error. For a predictable, bounded image-and-text section, use a Cover block instead.

Classic-theme method: the Customizer

If your site does not show Appearance → Editor, it may be using a classic theme.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Open Appearance → Customize.
  2. Choose Background Image if the theme provides that panel.
  3. Select an existing Media Library image or upload one.
  4. Set the available preset, position, attachment, repeat, or color options.
  5. Use the Customizer preview to inspect the result.
  6. Select Publish when the background looks correct.

The Customizer is theme-dependent and is generally hidden when a block theme is active. A classic theme must enable WordPress’s custom-background feature for these controls to appear; site owners normally do not need to change that code themselves.

Understand Cover, Contain, and Tile

Setting Use it when Trade-off
Cover You want the area filled edge to edge The image is resized to cover the entire area, so edges may be cropped
Contain The complete image must remain visible It may leave unused space around the image
Tile You are using a small texture or repeating pattern Repetition is intentionally visible

When Cover crops the subject, use the focal-point control where available. Check both desktop and mobile previews because a single focal point cannot prevent every responsive crop.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Why the image may not appear

There is no Appearance → Editor menu

Check Appearance → Customize. Your active theme may be classic, or a plugin or host configuration may affect available menus.

The selected block has no background control

That block or theme may not support background images. Switch to a Cover block for a section background, or use the global Styles background for a site-wide treatment.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The site-wide image is invisible in some regions

A template part or block with its own opaque background can sit above the global background. Inspect the affected region and remove or change that foreground background only where appropriate.

The image looks badly cropped

Change the focal point, adjust the Cover’s minimum height or content position, or choose Contain when showing the whole image matters more than filling the area.

The image repeats unexpectedly

Review repeat or Tile settings. Controls differ between the Site Editor, Cover block, and classic theme Customizer.

Practical checks before publishing

  • Confirm that the image is licensed for your site and stored in the Media Library.
  • Preview the relevant page, template, desktop layout, and mobile layout.
  • Check text contrast over the image; add an overlay or background color when needed.
  • Keep important subjects away from edges that may be cropped.
  • Save Site Editor changes or publish Customizer changes; previewing alone does not make them live.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Read next

Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.