Change WordPress Header Image: Step-by-Step Guide

Updated 10 November 2026 · Standard formula, shown below

To change a WordPress header image, open the site editor or Customizer, depending on your theme, and replace the image in the header or its background settings. The exact controls vary: block themes use the Site Editor, while many classic themes use Appearance → Customize.

Find the Right Header Controls

First identify which kind of theme your site uses. In your WordPress dashboard, check the Appearance menu:

Editor is available: Your site likely uses a block theme. Choose Appearance → Editor to edit templates and shared areas such as the header.
Customize is available: Your theme may be a classic theme with a Customizer. Open Appearance → Customize and look for Header Image, Header Media, or a similarly named section.
Neither option appears: Your account may not have permission to change the design, or the host or theme may provide a different editing route. Check the theme’s documentation or ask a site administrator.

Menu labels and available features depend on the theme and WordPress setup. The dashboard is a useful starting point, but there is no single header-image screen shared by every site.

Change the Image in a Block Theme

Block themes let you edit site-wide design elements with blocks. A header may contain a Site Logo, navigation, text, and a Cover or Image block rather than one dedicated “header image” setting.

In the dashboard, go to Appearance → Editor.
Open the design or template-part controls and select Patterns or Template Parts, if shown. Find the Header template part. In some versions, you can instead open a page or template and select the header directly in the preview.
Select the image or Cover block in the header. Use the List View button—the icon with horizontal lines—to locate blocks when they overlap or are difficult to click.
In the block toolbar or settings panel, choose the option to replace or select the image. Upload a new file or choose one from the Media Library.
Review the image’s crop, focal point, dimensions, and any overlay or text settings. Click Save and confirm the items WordPress says will be saved.

Changing a shared header can affect multiple pages or templates. Preview a few different parts of the site afterward, particularly if the header is responsive or uses different layouts on mobile.

Change the Image in a Classic Theme

Many classic themes put the setting in the Customizer. Open Appearance → Customize and look for Header Image, Header Media, or a theme-specific header section. Choose Add new image or Change image, select or upload a file, adjust the crop if prompted, then select Publish to apply the change.

The Customizer usually shows a preview before publication. If your theme offers multiple header images or a random-image option, check those settings too: a random selection may make the displayed image differ from the one you just chose.

Some older themes use a separate header image setting under Appearance → Header. Other themes do not support a header image at all. If you cannot find a relevant control, consult the theme’s help information rather than assuming the setting has been removed.

Choose and Prepare a Suitable Image

Use an image that fits the header’s shape and remains clear when cropped. A wide landscape photo may work well as a background, while a logo or illustration often belongs in a separate logo or image block. The theme’s suggested dimensions are a useful guide, but the displayed size can change across screens.

Check the crop: Keep important faces, text, and objects away from the edges. A wide desktop header may crop heavily on a phone.
Use an appropriate file: WordPress accepts common web-image formats, subject to the site’s configuration. Use a format supported by your theme and browsers; transparent logos generally need a format that preserves transparency.
Balance quality and file size: A very large image can slow loading without improving its appearance at the displayed size. Resize or compress it sensibly before uploading.
Consider contrast: If the header places text or navigation over the image, check that the text stays readable. An overlay or different text placement may help.
Use an image you have permission to publish: Do not assume that an image found online is free to reuse.

A header background and a site logo are different things. Replacing the background does not necessarily change the logo, and changing the logo does not necessarily replace the background image.

Preview, Save, and Check the Result

Before publishing, preview the header at more than one screen width if the editor offers responsive previews. Check the home page and at least one other page: shared headers should update across the site, but a particular template may use a different header.

After saving, view the public site in a fresh browser tab. If the old image remains, refresh the page and check whether a caching plugin, hosting cache, or content-delivery cache needs to be cleared. Also confirm that the editor actually saved or published the change; a preview alone does not always make it live.

For a reversible change, note the original image or keep a copy of it before replacing it. WordPress may retain uploaded media, but deleting a file from the Media Library can affect other pages that use it.

Common Problems and Fixes

No header-image option: The theme may use a block-based header or may not support a dedicated header image. Edit the header’s image or Cover block, or use the theme’s documented method.
The image looks zoomed or cut off: Check the crop, focal point, and background-size behavior. Try a wider source image with the subject nearer the center, then preview on mobile.
The change appears only in the editor: Save or publish the change, then refresh the public page. Clear relevant caches if it still shows the old version.
The image changed on some pages but not others: Those pages may use different templates or header parts. Inspect the template assigned to each page.
The upload fails: Check the file type and size, and try a smaller image in a common format. Hosting limits or site permissions can also prevent uploads.
The header looks different after a theme change: Header settings are theme-dependent. A new theme may not carry over the old design or use the same image controls.

Frequently Asked Questions

Can I change my WordPress header image without changing the theme?
Usually, yes, if the current theme provides an image setting or editable header block. You do not need to switch themes merely to replace an image.

Why can’t I find Header Image in WordPress?
Your theme may use the Site Editor and an Image or Cover block instead, or it may not support a dedicated header image. Check Appearance → Editor or the theme’s documentation.

Will changing the header image affect every page?
It often affects every page that uses the same shared header. Pages with a different template or custom header may remain unchanged.

What size should a WordPress header image be?
There is no universal size. Follow the theme’s recommendation where available, and preview the crop on desktop and mobile before publishing.

How do I change the header image on my phone?
WordPress’s dashboard may be accessible in a mobile browser, but editing controls can be cramped. If the interface is difficult to use, make the change from a desktop browser and check the mobile preview.

Why does my old header image still show?
Make sure the change was saved or published, then refresh the page. Browser, plugin, hosting, or delivery-network caches may need to be cleared.

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.