790

I have a few static pages that are just pure HTML, that we display when the server goes down. How can I put a favicon that I made (it's 16x16px and it's sitting in the same directory as the HTML file; it's called favicon.ico) as the "tab" icon as it were? I have read up on Wikipedia and looked at a few tutorials and have implemented the following:

<link rel="icon" href="favicon.ico" type="image/x-icon"/>
<link rel="shortcut icon" href="favicon.ico" type="image/x-icon"/>

But it still doesn't want to work. I am using Chrome to test the sites. According to Wikipedia .ico is the best picture format that runs on all browser types.

Update

I could not get this to work locally although the code checks out it will only really work properly once the server started serving the site. Just try pushing it up to the server and refresh your cache and it should work fine.

4
  • who don't you tell any of your friend to check it for you on some other system, same issue is with one of my client my system showing up fine and he's complaining favicon not showing up, i mostly use first one of you example and its correct. best of luck.
    – m-t
    Mar 30, 2012 at 13:45
  • 3
    Possible duplicate of How to add a browser tab icon (favicon) for a website? Mar 12, 2016 at 16:09
  • 1
    Your example is working now on Chrome. Aug 29, 2018 at 15:38
  • Interesting, the live website served up the favicon just fine, but when viewing the file locally, and not serving it through a local server (b/c it's simple static site - yea!), the favicon didn't show. In hindsight it makes sense, servers auto serve it up. Adding <link rel="icon" type="image/x-icon" href="favicon.ico"> to the head (next to the 32, 16, and 180 favicon variation links) solved the issue locally. Since I'd included links for the larger icon sizes, and the manifest, I didn't think twice about why favicon.ico wasn't showing up! :-) Mar 9, 2020 at 23:55

18 Answers 18

1191

You can make a .png image and then use one of the following snippets between the <head> tags of your static HTML documents:

<link rel="icon" type="image/png" href="/favicon.png"/>
<link rel="icon" type="image/png" href="https://example.com/favicon.png"/>
20
  • 4
    did you try putting "shortcut icon" in the rel= for your ico links and put a / before favicon.ico on both just to state that it is in the webroot dir?
    – Hazy McGee
    Mar 30, 2012 at 13:22
  • 1
    yip tried that too.. man lol i rate i am going to restart it all and then try boot up and see if maybe its cashing wrong or something.. Mar 30, 2012 at 13:27
  • 9
    I swear - i had the same problems after adding the code - it took maybe a day for the browser to display the icon instead of the grey box it usually has - try dumping ur browser cache history etc And if u copied my code make sure u change example.com to ur domain lol
    – Hazy McGee
    Mar 30, 2012 at 13:35
  • 4
    There is a redundant / in the top line href argument. Once I removed it it works like a charm. Should be: <link rel="shortcut icon" href="favicon.png" type="image/png">
    – drpawelo
    Jun 27, 2013 at 13:46
  • 5
    w3.org/2005/10/howto-favicon says to include a profile attribute in the head tag... is that necessary?
    – Rakib
    Jul 13, 2014 at 8:54
279

Most browsers will pick up favicon.ico from the root directory of the site without needing to be told; but they don't always update it with a new one right away.

However, I usually go for the second of your examples:

<link rel='shortcut icon' type='image/x-icon' href='/favicon.ico' />
3
  • does it have to be befoer the meta data or the script tags?? or not a problem Mar 30, 2012 at 13:34
  • 2
    As long as its in the <head> section, it shouldn't matter - because its not reliant on something else to work.
    – Codecraft
    Mar 30, 2012 at 13:50
  • 1
    MDN says to not use shortcut anymore.
    – Matthias
    Jan 21, 2022 at 18:31
142

Actually, to make your favicon work in all browsers, you must have more than 10 images in the correct sizes and formats.

I created an App (faviconit.com) so people don´t have to create all these images and the correct tags by hand.

Hope you like it.

6
  • 9
    Loved the app, no bs - straight to it, and the image can be edited before creating all the favicons +1 to you for saving me a bunch of time :)
    – SidOfc
    Jan 26, 2016 at 9:15
  • 1
    Agreed, this is a great app. While I don't think all those image sizes seem quite necessary, I love that it generates them and the required markup etc. Thanks!
    – andrhamm
    Oct 18, 2017 at 14:09
  • 1
    But it is proprietary. Mar 5, 2018 at 22:48
  • It doesn't work, gives Whoops, looks like something went wrong.
    – olfek
    Mar 24, 2018 at 14:07
  • @Eduardo, I read on faviconit.com that the service will be terminated on 03 October 2023. Can you please put the sources into GitHub? Maybe someone might want to continue providing this service?
    – Laszlo
    Sep 7, 2023 at 7:26
69

Usage Syntax: .ico, .gif, .png, .svg

This table shows how to use the favicon in major browsers. The standard implementation uses a link element with a rel attribute in the document's <head> section to specify the file format and filename/location.

Note that most browsers will give precedence to a favicon.ico file located in the website's root (therefore ignoring any icon link tags).

                                         Edge   Firefox   Chrome   I.E. Opera Safari  
 -------------------------------------- ------ --------- -------- ----- ----- ------ 
 <link rel="shortcut icon"               Yes    Yes       Yes      Yes   Yes     Yes
   href="http://example.com/myicon.ico">                          
 
 <link rel="icon"                        Yes    Yes       Yes      9     Yes     Yes
   type="image/vnd.microsoft.icon"                  
   href="http://example.com/image.ico">                        

 <link rel="icon" type="image/x-icon"    Yes    Yes       Yes      9     Yes     Yes
   href="http://example.com/image.ico">   

 <link rel="icon"                        Yes    Yes       Yes      11    Yes     Yes     
   href="http://example.com/image.ico"> 

 <link rel="icon" type="image/gif"       Yes    Yes       Yes      11    Yes     Yes
   href="http://example.com/image.gif">      

 <link rel="icon" type="image/png"       Yes    Yes       Yes      11    Yes     Yes
   href="http://example.com/image.png">     

 <link rel="icon" type="image/svg+xml"   Yes    Yes       Yes      Yes   Yes     No
   href="http://example.com/image.svg"> 

File format support

The following table illustrates the image file format support for the favicon:

                                         Animated                                
  Browser             ICO   PNG    GIF    GIF's   JPEG   APNG   SVG   
 ------------------- ----- ------ ------ ------- ------ ------ ------ 
  Edge                Yes   Yes    Yes    No      ?      ?      ?     
  Firefox             1.0   1.0    1.0    Yes     Yes    3.0    41.0  
  Google Chrome       Yes   Yes    4      No      4      No     No    
  Internet Explorer   5.0   11.0   11.0   No      No     No     No    
  Safari              Yes   4      4      No      4      No     No    
  Opera               7.0   7.0    7.0    7.0     7.0    9.5    44.0  

Browser Implementation

The table below illustrates the different areas of the browser where favicon's are displayed:

                      Address     Address bar 'Links'                       Drag to  
  Browser             Bar         drop-down     bar       Bookmarks   Tabs   desktop  
 ------------------- ------------ ----------- --------- ----------- ------ --------- 
  Edge                No            Yes         Yes       Yes         Yes    Yes      
  Firefox             until v12     Yes         Yes       Yes         Yes    Yes      
  Google Chrome       No            No          Yes       Yes         1.0    No       
  Internet Explorer   7.0           No          5.0       5.0         7.0    5.0      
  Safari              Yes           Yes         No        Yes         12     No       
  Opera               v7–12: Yes    No          7.0       7.0         7.0    7.0      
                      > v14: No                                                      

Icon files can be 16×16, 32×32, 48×48, or 64×64 pixels in size, and 8-bit, 24-bit, or 32-bit in color depth.

While the information above is generally correct, there are some variations/exceptions in certain situations.

img See more detailed information at the source on Wikipedia.


Update: ("more info")

61

Convert your image file to Base64 string with a tool like this and then replace the YourBase64StringHere placeholder in the below snippet with your string and put the line in your HTML head section:

<link href="data:image/x-icon;base64,YourBase64StringHere" rel="icon" type="image/x-icon" />

This will work 100% in browsers.

6
  • 3
    I found another tool that does the conversion in JavaScript without transferring data to the server: jpillora.com/base64-encoder Additionally, it handles multiple files by drag and drop. Save the page to use it locally.
    – handle
    Oct 16, 2016 at 8:49
  • 2
    imho, best solution, because it honors the "static html" page and is completely self contained within the document. Nov 30, 2016 at 8:08
  • 2
    Best solution. Works with png files as well . <link href="data:image/png;base64,YourBase64StringHere" rel="icon" type="image/png" /> Apr 28, 2017 at 9:59
  • 1
    This will cause a long string to be added to every page. Use inline base64 for small images that are rarely sent to the user.
    – frodeborli
    Dec 10, 2018 at 8:43
  • 1
    This way your favicon is never cached, you send the whole string to the client each time, IHMHO using a url and therefore the browser cache feels 'cleaner/ better'
    – Michiel
    Jan 8, 2019 at 10:57
16

As recommended by W3.org, you can use the rel attribute to achieve this.

Example:

<head>
<link rel="icon" 
      type="image/png" 
      href="http://example.com/myicon.png">
...
15

If the favicon is a png type image, it'll not work in older versions of Chrome. However it'll work just fine in FireFox. Also, don't forget to clear your browser cache while working on such things. Many a times, code is just fine, but cache is the real culprit.

1
  • 1
    That's fine; it's very hard to install/keep an old version of Chrome anyway
    – Ky -
    Dec 9, 2018 at 7:19
10
<link rel="shortcut icon" type="image/ico" href="/favicon.ico"/>
<link rel="shortcut icon" type="image/ico" href="http://example.com/favicon.ico"/>
<link rel="shortcut icon" type="image/png" href="/favicon.png"/>
<link rel="shortcut icon" type="image/png" href="http://example.com/favicon.png"/>
8
<link rel="shortcut icon" type="image/png" href="/favicon.png"/>
 <link rel="shortcut icon" type="image/ico" href="http://example.com/favicon.ico"/>

This worked for me

2
  • 4
    While this may work, you can't use image/png as the MIME Type - because it's incorrect considering you're using .ico
    – zanderwar
    Feb 19, 2016 at 6:35
  • Does "worked for me" include Safari on iOS?
    – Matthias
    Jan 21, 2022 at 18:39
5

I know its older post but still posting for someone like me. This worked for me

<link rel='shortcut icon' type='image/x-icon' href='favicon.ico' />

put your favicon icon on root directory..

5

Minimal favicon without "type" attr

<link href='favicon.png' rel='icon' />

You can even omit the quotes, but not recommended in production.

4

As per OP's update, It was not showing up locally, but as per OP's update, once I uploaded it to the server, it was fine.

Since this is a simple, static html website, I have the luxury of working on it without running a local webserver.
A webserver will generally automatically serve up the favicon, if there is one, by default.

But when not running a webserver, the browser itself will not just read the directory looking for additional files, say a favicon.ico, unless it is listed in the html document.

So, while I had the following items in the head tag:

    <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
    <link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
    <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
    <link rel="manifest" href="/site.webmanifest">

I did not also include a reference for plain 'ol favicon.ico.
Even though, the favicon.ico file was included, in addition to the images listed above.

Once I added the following line:

    <link rel="icon" type="image/x-icon" href="favicon.ico">

It did also show up in my browser, when I viewing the local file, even when not serving it through a local server.

So icon showed up fine when it ran on the live server, but not locally.

I mention this explicitly because the favicon generator I used, kindly supplied the code, icons, manifest, and instructions. However, while it included the favicon.ico image, it did not include a <link> to that file in the code to add to the html document.
I guess that service presumes favicon.ico will automatically be served up and used by all browsers by default, so only the "alternate" versions needed to be explicitly added to the head tag.
Evidently, they don't consider that when viewing files locally (aka not serving them up locally), we aren't interested in seeing the favicon?

1
  • "A webserver will generally automatically serve up the favicon" -- technically, the browser requests it. The server doesn't just serve it without it being requested by the browser. Maybe the browser doesn't do this for file:/// urls.
    – Matthias
    Jan 21, 2022 at 18:41
3

as an additional note that may help someone some day.

You can not echo anything to the page before:

Hello
<link rel="shortcut icon" type="image/ico" href="/webico.ico"/>
<link rel="shortcut icon" type="image/ico" href="/webico.ico"/>

will not load ico

<link rel="shortcut icon" type="image/ico" href="/webico.ico"/>
<link rel="shortcut icon" type="image/ico" href="/webico.ico"/>
Hello

works fine

2
  • 3
    That is because it is supposed to be in the head section of an HTML document, and is ignored by most browsers if it isn't. Jun 25, 2015 at 11:04
  • Yea, I just wanted to put this here in case anyone ran into a problem. My problem was the "hello" was some debug code and had me stumped for a bit.
    – bart2puck
    Jun 25, 2015 at 15:09
2

I used convert -resize 16x16 img.png favicon.ico (on linux konsole) to convert my image, and add <link rel="icon" href="images/favicon.ico" type="image/png" sizes="16x16"> to my header and everything work perfect.

1
  • You need a multi-layered icon with sizes larger than 16px, for higher DPI screens and who knows what else -- mobile "install to home screen" use cases.
    – Matthias
    Jan 21, 2022 at 18:43
1

If you add the favicon into the root/images folder with the name favicon.ico browser will automatically understand and get it as favicon.I tested and worked. your link must be www.website.com/images/favicon.ico

For more information look this answer:

Do you have to include <link rel="icon" href="favicon.ico" type="image/x-icon" />?

1
  • Where does the /images/ come from? You probably have a base element in your page. By default, favicons serve from /. But this is the old way; domains typically hold more than one site now. It's best to add the icon meta tag.
    – Matthias
    Jan 21, 2022 at 18:45
1

Notice that if your site is running as a subfolder ie:

http://localhost/MySite/

You will need to take that into account. If you are doing so from an ASP.NETapp all you need to do is add a ~ to the front of the URL:

<link rel="shortcut icon" type="image/x-icon" href="~/favicon.ico" />
2
  • ~ is not a thing in the world of URLs. /favicon.ico is correct. Is ASP.net doing some rewriting of urls? Check the actual page source as served, with "Inspect Element" or "View page source".
    – Matthias
    Jan 21, 2022 at 18:46
  • Yes, ASP.NET MVC converts a ~ to convert the physical path of the file to its actual online url.
    – Serj Sagan
    Jan 21, 2022 at 23:59
0

Note that FF fails to load an icon with a redundant // in URL like /img//favicon.png. Tested on FF 53. Chrome is OK.

1
  • 1
    That's not really an answer as much as it is a comment. (See "How to Answer".)
    – ashleedawg
    Dec 15, 2018 at 17:23
-1

Try to use the <link rel="icon" type="image/ico" href="images/favi.ico"/>

Not the answer you're looking for? Browse other questions tagged or ask your own question.