Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Setup & site building · Guide

How to Add and Resize a Logo in WordPress

How to Add and Resize a Logo in WordPress

Short answer

To add a logo in WordPress, open Appearance, then Customize, then Site Identity on a classic theme and click Select Logo, or add the Site Logo block in the Site Editor on a block theme. Pick or upload your image, crop it if asked, and click Publish or Save. Resize it with the Site Logo block width slider, and upload the file at about twice the size it shows on screen.

Key takeaways

  • WordPress has offered a built-in logo setting since version 4.5, through Site Identity on classic themes.
  • In a block theme, the Site Logo block places the logo, and a change to it applies everywhere the block appears.
  • The Twenty Sixteen theme suggests a logo of 240 px by 240 px, and each theme sets its own suggested size.
  • Site icon images should be square and at least 512 px by 512 px.
  • PNG with a transparent background suits most logos, and vector formats stay sharp at any size.

Where do you add a logo in WordPress?

Add a logo in Appearance, then Customize, then Site Identity on a classic theme, or with the Site Logo block in the Site Editor on a block theme.

The place depends on your theme type. A classic theme shows Customize in the Appearance menu, while a block theme shows Editor instead. The guide to what a block theme is explains how to tell which type you run.

WordPress has offered a built-in logo setting since version 4.5, when the custom logo feature was introduced, as stated in Learn WordPress. The logo replaces the text site title in the header, so visitors see your mark instead of plain words.

Check your theme first. Not every theme supports a custom logo, and a theme that skips the feature shows no logo option in Site Identity.

How do you add a logo with the Customizer?

Open Appearance, then Customize, then Site Identity, click Select Logo, pick or upload your image, and click Publish.

Follow these steps on a classic theme:

  1. Go to Appearance, then Customize in the dashboard.
  2. Select Site Identity in the Customizer panel.
  3. Click Select Logo at the top of the section.
  4. Pick an image from the Media Library or click Upload Files to add a new one.
  5. Add alt text, then click Select.
  6. Crop the image if WordPress asks, or click Skip Cropping.
  7. Click Publish at the top of the Customizer.

These steps come from Learn WordPress, which lists the same menu path and the same crop step. The live preview on the right shows the logo in your header before you publish.

You can also hide the text title next to the logo. Uncheck “Display Site Title and Tagline” in the same panel, and only the image shows.

How do you add a logo in a block theme?

Open Appearance, then Editor, open the header template part, add or select the Site Logo block, and choose your image.

The Site Logo block is the block-theme way to place a logo. WordPress.org documentation states that the block lets you add a logo that represents your site identity and helps brand recognition.

Follow these steps:

  1. Go to Appearance, then Editor in the dashboard.
  2. Open the header template part, or the template that shows your header.
  3. Click the Site Logo block, or add one with the block inserter (+) if the header has none.
  4. Click Choose Logo, then upload an image or pick one from the Media Library.
  5. Save the template part.

A change to the Site Logo block applies everywhere the block appears. WordPress.org documentation states that once you add an image logo, the change applies to all Site Logo blocks on your site.

The block links to your home page by default. The “Link image to home” option is turned on by default, as stated in the same Site Logo block documentation. Leave it on, since visitors expect a logo click to return home.

What size should a WordPress logo be?

Match the width your theme or block asks for, and upload the file at about twice the size it shows on screen.

There is no single logo size in WordPress. Each theme suggests its own size, and the Site Logo block sets the display width in the editor. Learn WordPress gives one example: the Twenty Sixteen theme suggests a logo of 240 px by 240 px.

Use these starting points when your theme gives no number:

  • A wide text logo often shows at 150 to 250 px wide in the header.
  • A square mark often shows at 40 to 60 px wide.
  • A retina screen packs twice the pixels into the same space, so a file at twice the display width stays sharp.

Uploading a 4,000 px file does not help. WordPress still shows it at the theme width, and the extra bytes slow the page. Export the logo close to twice its display size and no larger.

The guide to sizing images in WordPress covers the same idea for photos and graphics: serve the size the page shows, not the size the camera saved.

Use PNG with a transparent background for most logos, and use a vector format such as SVG when your theme supports it.

PNG keeps sharp edges and supports transparency, so the logo sits cleanly on any header color. A JPEG has no transparency and blurs text edges, so it suits photos, not logos.

Vector formats suit logos, text and icons. web.dev states that vector graphics are ideally suited to images made of simple shapes such as logos, text or icons, and that they deliver sharp results at every resolution. A vector logo stays sharp on a phone and on a large monitor from one file.

FormatBest forTransparencyNotes
PNGMost logosYesSharp edges, larger files than vector
SVGSimple marks and text logosYesStays sharp at any size, needs theme support
JPEGPhotos onlyNoNo transparency, softens text edges
WebPSmall raster logosYesSmaller files, check your theme accepts it

WordPress does not accept every format in the Media Library by default, so check your theme documentation before you rely on SVG. If the upload fails, export a PNG version and use that.

How do you resize a logo after adding it?

In a block theme, select the Site Logo block and change the width slider, or drag the handles; in a classic theme, look for a size setting in your theme options.

The Site Logo block gives you direct control. WordPress.org documentation states that you can resize the logo with the drag handles, and that the block settings panel lets you change the image width with a slider or by typing a number.

In a classic theme, the size control depends on the theme. Some themes add a logo width or header size setting under Customize. Others fix the size in the theme files, and then you change it with Additional CSS or a child theme.

Keep the height automatic when you resize. A fixed width with an automatic height keeps the logo shape true. A fixed width and a fixed height can stretch a wide logo into a square.

How do you use your logo as the site icon?

Turn on “Use as site icon” in the Site Logo block settings, or upload a square image of at least 512 px by 512 px in Site Identity.

The site icon is the small image in browser tabs, bookmark bars and phone home screens. Learn WordPress states that site icon images should be square and at least 512 px by 512 px, and that WordPress offers a crop step when the image is not square.

In a block theme, the Site Logo block has a “Use as site icon” option. WordPress.org documentation states that it sets the logo image as the site icon in browser tabs, bookmark bars and WordPress mobile apps.

Use a simple version of the mark for the icon. A wide text logo shrinks to unreadable size at 16 px in a tab. A square mark or a single letter reads far better.

Why is my logo not showing?

The usual causes are a theme without logo support, a logo set in the wrong place, or a cached page showing the old header.

Work through these checks in order:

  • Confirm the theme supports a custom logo. The Site Identity panel shows no Logo section when the theme does not support it.
  • Confirm you published the change. The Customizer preview is not live until you click Publish.
  • Confirm you edited the right template part. In a block theme, each template can carry its own header, so edit the header template part, not one page.
  • Clear any cache plugin and reload the page in a private window.

The guide to editing the header in a block theme shows where the header template part lives and how to open it. If the logo still does not appear, check your theme documentation for its own logo setting, since some themes add one outside Site Identity.

What mistakes should you avoid?

Do not upload a huge file, stretch the logo, or hide the site title without a plan for search results.

  • Do not upload the print file. A logo exported for print can weigh several megabytes and slow every page.
  • Do not stretch the logo to fill a wide header. White space around a small mark looks better than a distorted mark.
  • Do not use a JPEG with a white box on a dark header. The box shows, and the header looks broken.
  • Do not remove the site title and tagline without checking the result. The title text helps visitors and search engines know what the site is.
  • Do not set a different logo on every template. One logo, set once, keeps the site consistent.

The comparison of block themes and classic themes helps you pick the right editing route before you start, so you do not set the logo in a panel your theme ignores.

Frequently asked questions

Can I add a logo to WordPress without a plugin?

Yes. WordPress includes a logo setting in the Customizer for classic themes and the Site Logo block for block themes, so no plugin is needed. Upload a PNG with a transparent background, publish the change, and check the header on the live site. A plugin is only needed for extra features such as a different logo on mobile.

Why does my WordPress logo look blurry?

A logo looks blurry when the uploaded file is smaller than the size it shows at, or when a small raster image is stretched wide. Upload the file at about twice its display width, and use a PNG or a vector file rather than a JPEG. Check the result on a phone, where high-density screens show soft edges first.

What size should my WordPress logo be?

There is no single size, because each theme suggests its own. The Twenty Sixteen theme suggests 240 px by 240 px, and the Site Logo block sets the display width in the editor. A good rule is to upload the file at about twice the width it shows on screen, so it stays sharp on high-density displays.

Can I use my logo as the site icon too?

Yes, in a block theme turn on Use as site icon in the Site Logo block settings. In a classic theme, upload a square image of at least 512 px by 512 px in the Site Identity panel. Use a simple square mark for the icon, since a wide text logo shrinks to unreadable size in a browser tab.

Why does my logo not show after I save it?

First confirm the theme supports a custom logo, since the Logo section only appears when it does. Then confirm you clicked Publish in the Customizer or saved the template part in the Site Editor. Clear any cache plugin and reload in a private window, and check that you edited the header template part, not a single page.

Sources

  1. Customizer: Site Icons And Logo Learn WordPress
  2. Site Logo block WordPress.org
  3. Site Logo block reference Developer.WordPress.org
  4. Choose the right image format web.dev

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.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.