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 a Favicon (Site Icon) in WordPress

How to Add a Favicon (Site Icon) in WordPress

Short answer

To add a favicon in WordPress, upload a square PNG of at least 512 by 512 pixels as your Site Icon. On WordPress 6.5 or later, go to Settings, then General, and click Choose a Site Icon. On a classic theme, use Appearance, then Customize, then Site Identity instead.

Key takeaways

  • WordPress calls a favicon a Site Icon, and the feature has existed since WordPress 4.3.
  • Upload a square PNG of at least 512 by 512 pixels, and WordPress makes the smaller sizes.
  • On WordPress 6.5 or later, the Site Icon setting lives under Settings, then General.
  • Google shows a favicon in search results when it is square, at least 8 by 8 pixels, and crawlable.
  • A new icon can take days to appear, since browsers, caches and Google hold the old one.

What is a favicon in WordPress?

A favicon is the small square icon that stands for your site in browser tabs, bookmarks and phone home screens, and WordPress calls it the Site Icon.

Learn WordPress's lesson on site icons defines the site icon as a small graphic that appears in the browser menu bar, next to a link in the browser favorites menu, and as an icon when a site is saved to a smartphone.

The word “favicon” comes from “favorites icon”, but the dashboard never uses that word.

You have seen favicons even if you never set one. Open five tabs in your browser and each tab shows a tiny icon next to its title.

Sites without an icon show a blank page or a generic globe instead. That small picture is how visitors pick your tab out of a row of tabs.

A favicon is not a logo, though the two often share the same mark. A logo sits in your header at a large size, while a favicon is a tiny square that must read at 16 pixels wide.

A full logo with text in it rarely works at that size, so most sites use a simplified mark.

What image should you use for a favicon?

Use a square PNG image that is at least 512 by 512 pixels, with a simple mark that stays clear when shown very small.

Learn WordPress's lesson on site icons states the rule plainly: images should be square and a minimum of 512 pixels by 512 pixels. If your image is not square, WordPress offers to crop it inside the dashboard.

Design for the tiny size, not the large one. Keep these points in mind:

  • Use one mark, such as a letter or a simple shape, with no small text.
  • Keep the mark clear of the edges, so the crop does not cut it.
  • Use strong contrast, so the icon reads on white, gray and dark tab bars.
  • Use a PNG file, since it keeps transparency and survives the resizes WordPress performs.

A square image of exactly 512 by 512 pixels is the best starting point, since WordPress can use it as is. A larger square also works, since WordPress crops and resizes it. A smaller image will look soft, because WordPress stretches it up to the sizes it needs.

Where you set the icon depends on your setup:

SetupWhere to set the Site Icon
WordPress 6.5 or later, any themeSettings, then General, then Site Icon
Classic theme, or WordPress 4.3 to 6.4Appearance, then Customize, then Site Identity
Block themeAppearance, then Editor, then Site Logo block

How do you add a favicon in Settings > General?

Go to “Settings”, then “General”, find “Site Icon”, click “Choose a Site Icon”, upload a square image of at least 512 by 512 pixels, and save the page.

This route works on WordPress 6.5 and later, on any theme. Jetpack's WordPress favicon guide states that on most sites running WordPress 6.5 or later, you can add the icon in “Settings”, then “General”, then “Site Icon”.

The setting moved to the General page in WordPress 6.5, which was released on 2 April 2024.

Follow these steps:

  1. Log in to your WordPress dashboard with an account that can change site settings.
  2. Go to “Settings”, then “General”.
  3. Scroll to “Site Icon” and click “Choose a Site Icon”.
  4. Pick an image from the Media Library, or upload a new square PNG.
  5. Crop the image if WordPress asks you to.
  6. Click “Save Changes” at the bottom of the page.

Once an icon is set, the button changes to “Change Site Icon”, and a “Remove Site Icon” button appears next to it. Open the site in a private window after saving, so you see the new icon instead of the old one held in your browser cache.

How do you add a favicon with the Customizer?

Go to “Appearance”, then “Customize”, then “Site Identity”, and pick your image in the “Site Icon” section at the bottom.

The Site Icon feature has lived in the Customizer since WordPress 4.3, and Learn WordPress's lesson on site icons walks through these exact steps. This is the route to use on a classic theme, or on WordPress older than 6.5.

Follow these steps:

  1. In the WordPress dashboard, go to “Appearance”, then “Customize”.
  2. Select “Site Identity”.
  3. At the bottom, in the “Site Icon” section, click the “Select Image” button.
  4. Browse your computer to find and upload your file, or pick one from the Media Library.
  5. Add alternative text and click “Select”.
  6. If your image is not square, crop it when WordPress prompts you.
  7. Click “Save & Publish” at the top of the Customizer.

After cropping, the Customizer shows a preview of your site icon in the browser tab, so you can see how it looks before you publish. If you like the way it looks, click “Save & Publish” to keep it.

The Customizer route and the Settings route write the same site icon, so use whichever one your setup shows.

How do you set a favicon from the Site Editor?

Open the Site Editor, select the Site Logo block, and turn on “Use as site icon” to use your logo, or follow the “Site Icon Settings” link to pick a different image.

This route is for block themes, which do not show the Customizer menu. Learn WordPress's lesson on logos and site icons explains that with a block theme, you add and remove the site icon without the Customizer, from the Site Editor.

Follow these steps:

  1. Go to “Appearance”, then “Editor”.
  2. Click the Site Logo block in the header.
  3. Open the block settings panel.
  4. If you want to use your logo as the icon, leave the “Use as a site icon” toggle on. It is on by default.
  5. If you want a different icon, click the “Site Icon Settings” link instead.
  6. That link takes you to the Customizer, then “Site Identity”, where you pick an image as in the steps above.
  7. Click “Save” in the Site Editor, or “Publish” in the Customizer, to keep the change.

The same lesson notes that your logo will be cropped if it is not square, and that you can change its style from the Styles or Settings panel of the block.

A logo with text in it makes a poor icon, so use the settings link to pick a plain square mark instead. See how to edit the header in a block theme for where the Site Logo block lives.

How do you change or remove a favicon?

Upload a new image wherever you set the first one, or click “Remove Site Icon” to take the icon off the site.

To change the icon in WordPress 6.5 or later, go to “Settings”, then “General”, and click “Change Site Icon” under the current preview. Pick a new square image, crop it if asked, and click “Save Changes”. The new icon replaces the old one everywhere at once.

To change it on a classic theme, go to “Appearance”, then “Customize”, then “Site Identity”, and click “Change Image” in the “Site Icon” section.

Learn WordPress's lesson on logos and site icons shows the same path for removing it: open “Site Identity”, click “Remove” in the “Site Icon” section, then click “Publish”.

To remove the icon in WordPress 6.5 or later, use the “Remove Site Icon” button under the preview in “Settings”, then “General”. Removing the icon brings back the blank tab icon, so only remove it if you plan to upload a better one right away.

Why does Google show a favicon in search results?

Google shows your favicon next to your listing in search results when your icon meets its guidelines, so visitors can spot your site while they scan the page.

Google Search Central's favicon guide lists the rules for that display. Your favicon must be a square with a 1:1 aspect ratio that is at least 8 by 8 pixels, and Google recommends using one larger than 48 by 48 pixels so it looks good on different surfaces.

The same guide lists the file formats Google Search supports: BMP, GIF, ICO, PNG, JPEG, PPM and TIFF. Google allows only one favicon per site, where a site means a hostname.

That means “example.com” and “news.example.com” can have different icons, but a subdirectory cannot have its own. The favicon URL must stay stable, and Google must be able to crawl both your home page and the icon file.

WordPress covers the size rule by itself, since its 512-pixel minimum is far above Google's 48-pixel recommendation. You do not need to do extra work for search results once the Site Icon is set, but you do need to wait.

Google picks up the new icon on its own crawl, which can take days. For more on how your site appears in search, see how to add Open Graph tags.

Why is your new favicon not showing?

Check the browser cache first, then the caching plugin and CDN, since each of them can hold the old icon after you change it.

Favicons stick in caches longer than most files, so a new icon can look broken when it is only cached. Follow these steps in order:

  1. Open the site in a private window and hard refresh the page.
  2. Clear your browser cache if the old icon still shows.
  3. Purge the cache in your caching plugin, then reload.
  4. Purge the CDN cache if your site uses one.
  5. Wait a day, then check again, since Google's search display updates on its own crawl.

Also check the image itself. A non-square upload gets cropped, and a crop that cuts the mark can leave an icon that looks blank at tab size.

An SVG file will not work as a Site Icon, since SVG is not an allowed upload type in WordPress and Google does not list SVG among its supported favicon formats.

If the setting itself is missing, check your WordPress version under “Dashboard”, then “Updates”. The “Site Icon” field in “Settings”, then “General”, needs WordPress 6.5 or later, so update first or use the Customizer route on an older version.

What mistakes should you avoid?

Avoid uploading a small or wide image, and avoid using your full logo with text as the icon.

Watch out for these common mistakes:

  • Uploading an image smaller than 512 by 512 pixels. WordPress stretches it up, and the icon looks soft in every place it appears.
  • Uploading a wide logo and letting WordPress crop it. The crop can cut the text, so start with a square mark instead.
  • Using an SVG file. WordPress does not accept it as a Site Icon, and Google does not list it as a supported favicon format.
  • Forgetting the phone home screen. The same icon becomes an app icon when a visitor saves your site, so check it on a phone too.
  • Judging the change too fast. Browser caches hold the old icon for a long time, so check in a private window before you assume the upload failed.

Set the icon once, with a square PNG of at least 512 by 512 pixels, and it will serve your tabs, bookmarks, phone home screens and search results from a single upload. For the wider picture of site identity in search, see how to add schema markup.

Frequently asked questions

What size should a WordPress favicon be?

Use a square image of at least 512 by 512 pixels, ideally a PNG. WordPress crops the image if it is not square and makes the smaller sizes itself. A smaller upload gets stretched and looks soft, so start with a full-size square.

Where is the favicon setting in WordPress?

On WordPress 6.5 or later, it is under Settings, then General, then Site Icon, on any theme. On older versions or a classic theme, it is under Appearance, then Customize, then Site Identity. On a block theme, you can also set it from the Site Logo block.

Can I use my logo as my favicon?

You can, since the Site Logo block has a Use as site icon toggle that is on by default. A full logo with text rarely reads well at tab size, though, so a plain square mark usually works better as the icon.

Why is my new favicon not showing?

Check the browser cache first, then your caching plugin and CDN, since each can hold the old icon. Open the site in a private window and hard refresh. Google's search display also updates on its own crawl, which can take days.

Does Google require a specific favicon format?

Google Search supports BMP, GIF, ICO, PNG, JPEG, PPM and TIFF, and the icon must be square with a 1:1 aspect ratio and at least 8 by 8 pixels. Google recommends one larger than 48 by 48 pixels, and SVG is not on its supported list.

Sources

  1. Customizer: Site Icons and Logo Learn WordPress
  2. How to add and remove logo and site icon in Site Editor Learn WordPress
  3. Define a favicon to show in search results Google Search Central
  4. How to Add or Change a WordPress Favicon (Site Icon) Jetpack
  5. Site Editor WordPress.org

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.