Why Your Favicon Is Not Showing in Safari
An icon that appears in one browser can be blank in Safari because it reads different link entries and keeps its own icon cache. This guide separates the tab, home screen and pinned tab icons, then gives a head block and a check order for any stack.
Safari reads icons differently
A head that works elsewhere can leave Safari with a blank tab. Safari has historically relied on raster icons such as ICO and PNG, while other engines accept an SVG favicon. If SVG is your only entry, add a raster fallback. What a favicon is explains the entries.
A tab, an iPhone home screen shortcut and a pinned tab are separate features with separate entries, so a fix in one place does not fix the others. Build the set from one square image with the myfavicon generator.
| Symptom in Safari | Check first |
|---|---|
| Blank tab or generic icon | No ICO or PNG fallback in the head |
| Old artwork after a redeploy | Cached icon URL, not the source file |
| Wrong icon on a home screen | Missing apple-touch-icon entry |
Ship a raster fallback first
Declare several icons and let the browser choose. Keep an ICO and a PNG with an explicit sizes value, then add the SVG as an enhancement. SVG favicon support has varied across Safari versions and settings, so keep the raster entries.
Use root paths so a build does not rewrite them, and keep filenames identical in the tags and on disk. ICO vs PNG covers formats and the size guide lists dimensions.
<!-- served HTML, inside <head> -->
<link rel="icon" href="/favicon.ico" sizes="any">
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32.png">
<link rel="icon" type="image/svg+xml" href="/favicon.svg">
<link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
The mask-icon entry is a separate thing
Safari also introduced rel="mask-icon" for pinned tabs. It expects a monochrome SVG with solid black shapes and uses the color attribute to tint them. It is not the tab favicon and will not repair a missing one; some Safari versions no longer show pinned tab icons, so treat it as optional.
Keep the artwork simple if you ship it: filled shapes, no gradients, no thin outlines. The SVG favicon guide describes what stays legible at small sizes.
<!-- optional, for pinned tabs in Safari -->
<link rel="mask-icon" href="/safari-pinned-tab.svg" color="#333333">
<!-- safari-pinned-tab.svg: one solid shape -->
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16">
<path fill="#000000" d="M2 2h12v12H2z"/>
</svg>
Home screen icons use apple-touch-icon
When someone chooses Add to Home Screen on an iPhone or iPad, Safari looks for rel="apple-touch-icon", not the favicon. Without it the OS captures the page instead, which is why a correct desktop tab can pair with a poor shortcut.
Use an opaque square PNG and let the OS apply rounding and shading. The Apple touch icon page covers the declaration; the web manifest and PWA icons cover installed apps.
| Where the icon appears | Entry Safari reads |
|---|---|
| Desktop tab | icon with an ICO or PNG fallback |
| iPhone home screen | apple-touch-icon |
| Installed web app | icons array in the manifest |
Clear the cached icon
Safari keeps tab icons in a cache that a normal refresh does not always clear. If the head is correct and the file on disk is new but the old artwork stays, the cause is a cached copy, not a broken link.
Change the URL instead of fighting the cache: rename the file or append a version query string, then redeploy. The general not-showing guide walks through the same path and cache checks for other browsers.
Verify what the server actually sends
Read the served HTML rather than your template. Framework configs, redirects and CDN rules can change the head between source and response, so confirm every href resolves to an image and not a 404 page.
The favicon checker inspects a live URL from outside your browser. These terminal commands do the same two checks directly.
# check the headers for an icon file
curl -sSI https://example.com/favicon.ico | head -n 8
# confirm the served head contains the icon links
curl -sL https://example.com/ | grep -i 'rel="icon"'
A short checklist before you ship
Work through the list once, in order. Most Safari reports come down to a missing raster fallback, a home screen entry that was never added, or a cached URL. The general guide and pages for React, Vue and Next.js show the same head block in each build tool.
FAQ
The two engines do not always pick the same link entry. An SVG-only head is the usual cause; add an ICO or PNG fallback and reload.
Support has varied across Safari versions and settings. Keep an ICO or PNG entry as the baseline and treat the SVG as an optional enhancement.
No. It is used for home screen shortcuts on iPhone and iPad. The tab icon comes from the icon link entries in the head.
You should not treat it as a ranking factor. Its job is recognition in tabs, bookmarks and home screen shortcuts.