Setup & site building · Guide
How to Change the Logo in WordPress (Any Theme or Builder)

Short answer
To change the logo in a block theme, go to Appearance > Editor, open the header template part, click the Site Logo block and choose Replace. In a classic theme, go to Appearance > Customize > Site Identity and click Change Logo. If a page builder controls your header, edit the logo widget in that header template instead.
Key takeaways
- Block themes use the Site Logo block inside the header template part.
- Classic themes set the logo under Appearance > Customize > Site Identity.
- Page builder headers have their own logo widget that overrides the theme.
- Upload a sharp logo, ideally SVG or a PNG about twice the displayed size.
- The favicon, the small browser tab icon, is a separate setting called the Site Icon.
Where does WordPress store the site logo?
WordPress stores a single site logo setting that themes can display; block themes show it with the Site Logo block, while classic themes show it wherever their header template places it.
Because the setting is shared, changing the logo in one place usually updates it across the whole site. The exception is a page builder header, which may use its own image.
First check how your header is built. Look under Appearance for Editor, which means a block theme, or Customize, which usually means a classic theme.
If a page builder like Elementor shows a header template in its Theme Builder, that template controls the logo instead.
How do you change the logo in a block theme?
Go to Appearance > Editor, open Patterns or Template Parts, choose Header, click the Site Logo block, click Replace, upload or select your new logo, then click Save.
- Go to Appearance > Editor
- Open Patterns and select Header under Template Parts
- Click the Site Logo block
- Click Replace in the block toolbar
- Upload a new image or choose one from the Media Library
- Adjust the width in the block settings
- Click Save
The WordPress documentation for the Site Logo block explains its settings, including width and linking the logo to the homepage.
If your header has no Site Logo block, add one with the plus button. Some themes show only the site title by default.
How do you change the logo in a classic theme?
Go to Appearance > Customize > Site Identity, click Change Logo or Select Logo, upload your image, crop it if asked, and click Publish.
The Customizer documentation shows how the live preview lets you see the new logo before publishing.
Many themes add extra header options, such as logo width, a separate mobile logo or a different logo for transparent headers. Look in Header or Layout panels in the Customizer.
If the crop step cuts your logo badly, choose Skip Cropping. The theme then uses the full image and scales it.
How do you change the logo in a page builder header?
Open the header template in your page builder, such as Elementor's Theme Builder, select the logo or image widget, choose your new image and update the template.
Some builders use a Site Logo widget that reads the WordPress logo setting, while others use a plain image. With a Site Logo widget, changing the WordPress setting is enough.
Our guide on changing the header in WordPress covers builder headers and other header elements in more detail.
What size and format should the logo be?
Use an SVG file if your setup supports it, or a PNG with a transparent background at about twice the size it appears on screen, so it stays sharp on high-resolution displays.
If your logo shows at 200 pixels wide in the header, upload a PNG around 400 pixels wide. Much larger files only slow the page down.
WordPress does not allow SVG uploads by default because SVG files can contain code. Use a trusted plugin that sanitises SVGs if you want to use them.
Compress PNG files before uploading. Google's web.dev guide to image performance explains how size and format affect loading speed.
Why is SVG a good format for logos?
SVG is a vector format, so the logo stays perfectly sharp at any size and on any screen, and simple logos are often smaller as SVG than as PNG.
MDN's SVG documentation explains how the format describes shapes with code rather than pixels, which is why it scales cleanly.
Because SVG is code, a malicious file could include scripts. Only upload SVGs from your own designer or a trusted source, and use a plugin that sanitises them.
If SVG support is not an option, export a PNG at twice the display size and compress it. For most headers, the visual difference is small.
How do you set the logo width?
Set the width in the Site Logo block settings, the Customizer's header options or the page builder widget, rather than uploading a smaller or larger image file.
A width between 120 and 250 pixels suits most desktop headers, but the right size depends on your design and logo shape. Wide logos need more space than square ones.
Check the mobile header too, on a real phone if you can. Many themes let you set a smaller logo width for phones, so the menu button still fits.
How do you add a different logo for mobile or dark backgrounds?
Some themes offer separate settings for a mobile logo or a light logo for dark or transparent headers; otherwise, use your page builder or a custom header template to show different images.
A dark logo on a transparent header over a dark hero image can disappear. A white version for that case keeps the brand visible, and it is worth asking your designer for both versions at the start of a project.
In block themes, you can create a second header template part with a different logo and use it on specific templates.
How do you change the favicon?
The favicon, called the Site Icon in WordPress, is set separately under Appearance > Customize > Site Identity in classic themes, or in Settings > General or the Site Editor's site icon setting, depending on your WordPress version and theme.
Use a square image of at least 512 by 512 pixels. WordPress creates smaller sizes for browser tabs, bookmarks and home screen icons.
The WordPress guide to creating a favicon explains the requirements in more detail.
A simplified version of your logo, such as just the symbol or first letter, usually works better at tiny sizes than the full logo.
Why is the old logo still showing?
Clear your caching plugin, server cache, CDN cache and browser cache, then check that you edited the right header template and that no page builder header overrides the theme.
Caching is the most common reason. The new logo is saved, but visitors still receive an older copy of the page.
If you uploaded the new logo with the same file name as the old one, browsers may keep showing the cached image. Uploading the new file under a different name avoids this problem entirely.
If the old logo appears only on some pages, those pages may use a different header template part or a page-specific header setting.
Why is the logo blurry?
The image is probably too small for high-resolution screens or has been resized by the theme; upload a larger PNG or an SVG, and set the display width in the settings.
Avoid uploading a JPG for logos with text or transparency. JPG compression blurs sharp edges and cannot show a transparent background.
If your theme crops the logo to a fixed size, skip cropping during upload or adjust the theme's logo height setting.
Should you change the logo text and site title too?
Yes, check the Site Title and Tagline under Settings > General or Site Identity, since screen readers, search results and some themes use them even when a logo image is shown.
The site title often appears in browser tabs, RSS feeds and structured data. It should match the brand name in your logo.
Give the logo image meaningful alt text, usually your business name. The W3C's images tutorial explains how to describe logos for screen reader users.
What else should you update after a rebrand?
After changing the logo, update the favicon, social sharing images, email templates, invoices, form notifications and any logo used inside page content or footers.
WooCommerce emails, form plugin templates and SEO plugin social images all have their own logo settings. They are easy to forget.
Keep the old logo files in the Media Library until you are sure nothing still uses them. Our guide on removing the WordPress logo from a website covers WordPress branding that may still appear elsewhere.
Frequently asked questions
Where do I change the logo in WordPress?
In a block theme, edit the Site Logo block in the header template part under Appearance then Editor. In a classic theme, use Appearance then Customize then Site Identity.
What is the best logo size for WordPress?
Upload an SVG or a transparent PNG about twice the width it displays at, then set the display width in the theme or block settings. Very large files slow pages down.
Why can't I upload an SVG logo?
WordPress blocks SVG uploads by default because SVG files can contain code. Use a trusted plugin that sanitises SVG files, or upload a high-resolution PNG instead.
Is the favicon the same as the logo?
No. The favicon, called the Site Icon in WordPress, is a separate square image used in browser tabs and bookmarks. Set it in Site Identity or your site settings.
Why does my old logo still appear?
Usually because of caching. Clear your caching plugin, server, CDN and browser caches, and check that a page builder header is not overriding the theme's logo.
Sources
- Site Logo block WordPress.org Documentation
- Customizer WordPress.org Documentation
- Creating a Favicon WordPress.org Documentation
- Image performance web.dev
- Images Tutorial W3C Web Accessibility Initiative
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.


