Clear Favicon Cache on Safari: iPhone and Mac Guide
You shipped a new favicon, cleared cache in Safari on your Mac, and the new icon finally shows up in the tab. Then you open the same site on your iPhone — and the old gray placeholder is still there. To fix it, you have to clear favicon cache on Safari iPhone and Mac independently, because the two devices store their own icon databases and never sync them through iCloud.
Why Safari caches favicons differently on iPhone and Mac
Safari stores favicon data in two layers: a transient browser cache and a persistent WebpageIcons database that powers tabs, bookmarks, and the home screen Add to Home Screen flow. On macOS, this database lives at ~/Library/Safari/WebpageIcons.db. On iOS, it sits inside Safari's app sandbox where you cannot browse it directly.
The two caches never talk to each other. Updating your favicon on your Mac does nothing for your iPhone — and vice versa. That's why the same site can show two different icons at the same time across your devices.
Prerequisites
A deployed favicon file accessible at your site root or via an HTML <link rel='icon'> tag
Safari 14 or later on macOS and iOS 14 or later on iPhone
About 2 minutes per device
How to clear favicon cache on Mac
Step 1: Verify your new favicon is actually live
Open Safari, load your site, and view source (Cmd + Option + U). Confirm the <link rel='icon'> tag points to the new file. If your old file path is still hardcoded, no cache clearing will help — see our HTML favicon guide for the correct tags.
Step 2: Empty Safari's temporary cache
Go to Safari → Settings → Advanced and enable Show Develop menu in menu bar. Then click Develop → Empty Caches. This wipes the transient cache Safari uses for tab rendering, but it does not touch the WebpageIcons database.
Step 3: Wipe the WebpageIcons database directly
Quit Safari completely (Cmd + Q). Open Terminal and run:
These files store every favicon Safari has shown across all tabs and bookmarks. Deleting them forces Safari to rebuild the icon database from scratch on next launch.
Step 4: Restart Safari and reload
Reopen Safari and load your site. The new favicon should appear in the tab and bookmark bar within seconds. If it doesn't, your HTML is still pointing to the old file path.
How to clear favicon cache on iPhone
The iOS process is different. You cannot access Safari's file system directly, so the approach relies on forcing Safari to refresh by clearing site data from Settings.
Step 1: Clear Safari's website data
Open the Settings app, scroll to Safari, and tap Advanced → Website Data. Tap Remove All Website Data. This wipes cookies, cache, and Safari's touch icon store for every site.
Heads up: this signs you out of every website you're logged into. Use a private browsing session if you only want to test favicon changes without losing sessions.
Step 2: Force-quit Safari
Swipe up from the bottom (or double-click the home button on older iPhones) to open the app switcher. Swipe Safari up to force-quit it, then reopen it and load your site.
Step 3: Bypass the cache with a hard reload
Tap and hold the refresh button in Safari's address bar, then tap Request Desktop Site. Toggle it on, then off. This forces a fresh fetch including the favicon file. Alternatively, append a query string to break the cache:
https://yoursite.com/?v=2
Step 4: Refresh the Home Screen icon cache
If you added your site to the iPhone home screen, that icon comes from the apple-touch-icon file — not the standard favicon. To refresh it, delete the home screen shortcut, then re-add it. Safari will re-read the <link rel='apple-touch-icon'> tag from your HTML and download a fresh copy.
Common pitfalls
iCloud does not sync caches: clearing on your Mac does not affect your iPhone or iPad caches.
Service workers: if your site uses a service worker, it can serve a stale favicon from the Cache API. Bump your service worker version to force a refresh.
CDN edge caching: your favicon file may be cached at your CDN edge. Append a version query string like ?v=2 to your icon path in the HTML tag.
Private browsing: Safari's private mode does not persist favicon cache at all — testing in private mode will not reveal the same behavior as normal mode.
Prevent future favicon cache issues
Once your new icon shows correctly on both devices, prevent this from happening again by using content-hashed filenames:
Every deploy gets a unique URL, so browsers can never serve a stale cached copy. For deeper coverage of cache-busting patterns, see our favicon cache busting guide.
For a complete reference on the rel='icon' attribute and the MIME types browsers accept, check the WHATWG HTML Living Standard.
你刚上线了新的 favicon,在 Mac 上清完 Safari 缓存,标签页里终于出现了新图标。结果打开 iPhone 打开同一个网站——旧的那个灰色占位图还稳稳待在那里。要解决,你必须分别在 Safari iPhone 和 Mac 上清除 favicon 缓存,因为这两台设备各自维护着自己的图标数据库,根本不会通过 iCloud 同步。
새 파비콘을 배포하고 Mac의 Safari에서 캐시를 비웠더니 탭에 새 아이콘이 떴습니다. 그런데 같은 사이트를 iPhone에서 열면 아직도 옛 회색 placeholder만 남아 있습니다. 이 문제를 해결하려면 iPhone과 Mac의 Safari 파비콘 캐시를 각각 따로 지워야 합니다. 두 기기는 각자 자체 아이콘 데이터베이스를 가지고 있고, iCloud로 동기화되지 않기 때문입니다.
iPhone과 Mac에서 Safari의 파비콘 캐시 방식이 다른 이유
Safari는 파비콘 데이터를 두 계층에 저장합니다. 하나는 일시적인 브라우저 캐시이고, 다른 하나는 탭·북마크·홈 화면의 '홈 화면에 추가' 흐름을 지원하는 영구적인 WebpageIcons 데이터베이스입니다. macOS에서는 이 데이터베이스가 ~/Library/Safari/WebpageIcons.db 경로에 존재합니다. iOS에서는 Safari의 앱 샌드박스 내부에 있어서 사용자가 직접 탐색할 수 없습니다.
두 캐시는 서로 정보를 교환하지 않습니다. Mac에서 파비콘을 업데이트해도 iPhone에는 아무런 영향을 주지 못하고, 그 반대도 마찬가지입니다. 같은 사이트가 기기에 따라 동시에 서로 다른 아이콘을 표시할 수 있는 이유가 바로 이것입니다.
사전 준비
사이트 루트 또는 HTML <link rel='icon'> 태그로 접근 가능한 파비콘 파일이 배포되어 있어야 합니다
macOS에서 Safari 14 이상, iPhone에서 iOS 14 이상
기기당 약 2분의 시간
Mac에서 파비콘 캐시를 지우는 방법
1단계: 새 파비콘이 실제로 적용됐는지 확인
Safari를 열고 사이트에 접속한 다음 소스 보기로 (Cmd + Option + U) 페이지를 확인합니다. <link rel='icon'> 태그가 새 파일을 가리키는지 살펴봅니다. 예전 파일 경로가 그대로 하드코딩되어 있다면 아무리 캐시를 지워도 해결되지 않습니다. 올바른 태그 작성 방법은 HTML 파비콘 가이드를 참고하시기 바랍니다.
2단계: Safari의 임시 캐시 비우기
Safari → 설정 → 고급으로 이동해 메뉴바에 개발자 메뉴 표시 옵션을 활성화합니다. 그다음 개발자 → 캐시 비우기를 클릭합니다. 이렇게 하면 탭 렌더링에 사용되는 임시 캐시는 사라지지만, WebpageIcons 데이터베이스는 건드리지 않습니다.
3단계: WebpageIcons 데이터베이스를 직접 삭제
Safari를 완전히 종료합니다 (Cmd + Q). 터미널을 열고 다음 명령을 실행합니다.
이 파일들에는 Safari가 모든 탭과 북마크에서 표시했던 파비콘 정보가 저장되어 있습니다. 이 파일들을 삭제하면 다음 실행 시 Safari가 아이콘 데이터베이스를 처음부터 다시 빌드합니다.
4단계: Safari 재시작 후 새로 고침
Safari를 다시 열고 사이트를 불러옵니다. 새 파비콘이 몇 초 내에 탭과 북마크 표시줄에 나타나야 합니다. 그래도 예전 아이콘이 보인다면 HTML이 아직 옛 파일 경로를 가리키고 있는 것입니다.
iPhone에서 파비콘 캐시를 지우는 방법
iOS 절차는 다릅니다. Safari의 파일 시스템에 직접 접근할 수 없기 때문에, 설정에서 사이트 데이터를 지워 Safari가 강제로 새로 고침하도록 하는 방식을 사용합니다.
1단계: Safari의 웹사이트 데이터 지우기
설정 앱을 열고 Safari 항목까지 스크롤한 다음 고급 → 웹사이트 데이터를 탭합니다. 모든 웹사이트 데이터 제거를 선택합니다. 이렇게 하면 모든 사이트의 쿠키, 캐시, Safari의 터치 아이콘 저장소가 함께 삭제됩니다.
주의: 이 작업은 로그인해 둔 모든 웹사이트에서 로그아웃 처리합니다. 세션 손실 없이 파비콘 변경만 확인하고 싶다면 프라이빗 브라우징 세션을 활용하시기 바랍니다.
2단계: Safari 강제 종료
하단에서 위로 스와이프하거나(구형 iPhone의 경우 홈 버튼을 더블 클릭) 앱 전환기를 엽니다. Safari 카드를 위로 스와이프해 강제 종료한 다음 다시 열고 사이트를 불러옵니다.
3단계: 강제 새로 고침으로 캐시 우회
Safari 주소 표시줄의 새로 고침 버튼을 길게 누른 다음 Desktop 버전 요청을 탭합니다. 활성화했다가 다시 비활성화합니다. 이렇게 하면 파비콘 파일을 포함한 새 요청이 강제로 발생합니다. 다른 방법으로는 캐시를 무력화할 수 있도록 쿼리스트링을 붙이는 방법도 있습니다.
https://yoursite.com/?v=2
4단계: 홈 화면 아이콘 캐시 새로 고침
iPhone 홈 화면에 사이트를 추가해 둔 경우, 그 아이콘은 표준 파비콘이 아니라 apple-touch-icon 파일에서 가져옵니다. 이 아이콘을 새로 고치려면 홈 화면 바로 가기를 삭제했다가 다시 추가합니다. 그러면 Safari가 HTML의 <link rel='apple-touch-icon'> 태그를 다시 읽어 새 사본을 내려받습니다.
Limpiar la caché de favicon en Safari: guía para iPhone y Mac
Acabas de desplegar un favicon nuevo, limpiaste la caché de Safari en tu Mac y, por fin, el icono actualizado aparece en la pestaña. Entonces abres el mismo sitio en tu iPhone... y ahí sigue el viejo placeholder gris. Para arreglarlo, tienes que limpiar la caché de favicon en Safari del iPhone y del Mac por separado, porque ambos dispositivos almacenan sus propias bases de datos de iconos y nunca se sincronizan a través de iCloud.
Por qué Safari almacena en caché los favicons de forma distinta en iPhone y Mac
Safari guarda los datos de los favicons en dos capas: una caché transitoria del navegador y una base de datos persistente llamada WebpageIcons, que alimenta las pestañas, los marcadores y el flujo de Añadir a pantalla de inicio. En macOS, esta base de datos se encuentra en ~/Library/Safari/WebpageIcons.db. En iOS, vive dentro del sandbox de la app Safari, donde no puedes navegar directamente.
Las dos cachés no se comunican entre sí. Actualizar tu favicon en el Mac no afecta al iPhone, y viceversa. Por eso el mismo sitio puede mostrar dos iconos distintos al mismo tiempo en tus dispositivos.
Requisitos previos
Un archivo de favicon desplegado y accesible en la raíz de tu sitio o mediante una etiqueta HTML <link rel='icon'>
Safari 14 o posterior en macOS y iOS 14 o posterior en iPhone
Aproximadamente 2 minutos por dispositivo
Cómo limpiar la caché de favicon en Mac
Paso 1: comprueba que tu favicon nuevo está realmente activo
Abre Safari, carga tu sitio y revisa el código fuente (Cmd + Option + U). Confirma que la etiqueta <link rel='icon'> apunta al archivo nuevo. Si la ruta antigua sigue hardcodeada, no hay limpieza de caché que valga; consulta nuestra guía de favicon en HTML para ver las etiquetas correctas.
Paso 2: vacía la caché temporal de Safari
Ve a Safari → Ajustes → Avanzado y activa Mostrar menú Desarrollo en la barra de menús. Después haz clic en Desarrollo → Vaciar cachés. Esto borra la caché transitoria que Safari usa para renderizar pestañas, pero no toca la base de datos WebpageIcons.
Paso 3: elimina la base de datos WebpageIcons directamente
Cierra Safari por completo (Cmd + Q). Abre Terminal y ejecuta:
Estos archivos almacenan cada favicon que Safari ha mostrado en todas las pestañas y marcadores. Al eliminarlos, Safari reconstruye la base de datos de iconos desde cero en el siguiente inicio.
Paso 4: reinicia Safari y recarga
Vuelve a abrir Safari y carga tu sitio. El favicon nuevo debería aparecer en la pestaña y en la barra de marcadores en cuestión de segundos. Si no aparece, tu HTML sigue apuntando a la ruta antigua.
Cómo limpiar la caché de favicon en iPhone
El proceso en iOS es diferente. No puedes acceder al sistema de archivos de Safari directamente, así que el método se basa en forzar a Safari a actualizarse borrando los datos del sitio desde Ajustes.
Paso 1: borra los datos de sitios web de Safari
Abre la app Ajustes, desplázate hasta Safari y toca Avanzado → Datos de sitios web. Toca Eliminar todos los datos de sitios web. Esto borra cookies, caché y el touch icon store de Safari para todos los sitios.
Atención: esto cierra la sesión en todos los sitios en los que hayas iniciado sesión. Usa una sesión de navegación privada si solo quieres probar cambios de favicon sin perder tus sesiones.
Paso 2: fuerza el cierre de Safari
Desliza hacia arriba desde la parte inferior (o doble clic en el botón de inicio en iPhones más antiguos) para abrir el conmutador de apps. Desliza Safari hacia arriba para forzar su cierre y, después, vuelve a abrirlo y carga tu sitio.
Paso 3: esquiva la caché con una recarga completa
Mantén pulsado el botón de actualizar en la barra de direcciones de Safari y, a continuación, toca Solicitar sitio de escritorio. Actívalo y desactívalo. Esto fuerza una nueva descarga que incluye el archivo de favicon. Como alternativa, añade una cadena de consulta para romper la caché:
https://yoursite.com/?v=2
Paso 4: actualiza la caché del icono de la pantalla de inicio
Si añadiste tu sitio a la pantalla de inicio del iPhone, ese icono viene del archivo apple-touch-icon, no del favicon estándar. Para actualizarlo, elimina el acceso directo de la pantalla de inicio y, después, vuelve a añadirlo. Safari volverá a leer la etiqueta <link rel='apple-touch-icon'> de tu HTML y descargará una copia nueva.
Problemas habituales
iCloud no sincroniza cachés: limpiar en el Mac no afecta a las cachés de tu iPhone o iPad.
Service workers: si tu sitio usa un service worker, puede servir un favicon antiguo desde la Cache API. Sube la versión de tu service worker para forzar una actualización.
Caché de borde del CDN: tu archivo de favicon puede estar cacheado en el edge de tu CDN. Añade una cadena de versión como ?v=2 a la ruta del icono en la etiqueta HTML.
Navegación privada: el modo privado de Safari no conserva la caché de favicons en absoluto; probar en modo privado no reflejará el mismo comportamiento que el modo normal.
Evita futuros problemas con la caché de favicons
Cuando tu icono nuevo se muestre correctamente en ambos dispositivos, evita que vuelva a ocurrir usando nombres de archivo con hash de contenido:
Cada despliegue recibe una URL única, por lo que los navegadores nunca podrán servir una copia cacheada obsoleta. Para profundizar en patrones de cache busting, consulta nuestra guía de cache busting para favicons.
Para una referencia completa sobre el atributo rel='icon' y los tipos MIME que aceptan los navegadores, revisa el WHATWG HTML Living Standard.
Generate Favicon Files for Safari
Use Mzu favicondl to download ICO, PNG, and SVG favicons ready for Safari on iPhone and Mac.