Favycons Docs

Web Export Bundle

Complete favicon set for websites, PWAs, and web applications with all required formats and sizes.

Web Export Bundle

The Web export bundle provides everything you need for a complete favicon setup on any website or web application. It includes traditional favicons, PWA icons, Apple touch icons, and Windows tile support.

What's Included

FileSizePurpose
favicon.ico16, 32, 48pxMulti-size ICO for legacy browser support
favicon.svgScalableModern browsers with SVG favicon support
favicon-16x16.png16x16Standard favicon size
favicon-32x32.png32x32High-DPI displays
favicon-192x192.png192x192PWA icon (standard)
favicon-512x512.png512x512PWA icon (large/splash)
apple-touch-icon.png180x180iOS Safari "Add to Home Screen"
mstile-150x150.png150x150Windows Start menu tiles
site.webmanifestPWA configuration file
browserconfig.xmlLegacy IE/Edge tile configuration
meta-tags.htmlCopy-paste HTML snippet
SETUP.mdInstallation instructions

Installation

1. Extract Files

Extract the ZIP to your project's public/ folder:

your-app/
├── public/
│   ├── favicon.ico
│   ├── favicon.svg
│   ├── favicon-16x16.png
│   ├── favicon-32x32.png
│   ├── favicon-192x192.png
│   ├── favicon-512x512.png
│   ├── apple-touch-icon.png
│   ├── mstile-150x150.png
│   ├── site.webmanifest
│   └── browserconfig.xml

2. Add Meta Tags

Add these tags to the <head> of your HTML:

<!-- Favicon -->
<link rel="icon" type="image/x-icon" href="/favicon.ico">
<link rel="icon" type="image/svg+xml" href="/favicon.svg">
<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">

<!-- Apple -->
<link rel="apple-touch-icon" href="/apple-touch-icon.png">

<!-- PWA -->
<link rel="manifest" href="/site.webmanifest">
<meta name="theme-color" content="#ffffff">

<!-- Windows -->
<meta name="msapplication-config" content="/browserconfig.xml">

3. Customize the Manifest

Edit site.webmanifest to match your app:

{
  "name": "Your App Name",
  "short_name": "App",
  "icons": [
    {
      "src": "/favicon-192x192.png",
      "sizes": "192x192",
      "type": "image/png"
    },
    {
      "src": "/favicon-512x512.png",
      "sizes": "512x512",
      "type": "image/png"
    }
  ],
  "theme_color": "#ffffff",
  "background_color": "#ffffff",
  "display": "standalone"
}

Framework-Specific Setup

Next.js (App Router)

Next.js automatically serves files from the public/ folder. Place your icons there and add meta tags in app/layout.tsx:

export const metadata = {
  icons: {
    icon: [
      { url: '/favicon.ico' },
      { url: '/favicon-16x16.png', sizes: '16x16', type: 'image/png' },
      { url: '/favicon-32x32.png', sizes: '32x32', type: 'image/png' },
    ],
    apple: '/apple-touch-icon.png',
  },
  manifest: '/site.webmanifest',
};

Vite / React

Place files in public/ and add meta tags to index.html:

<head>
  <link rel="icon" href="/favicon.ico" />
  <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
  <link rel="manifest" href="/site.webmanifest" />
</head>

Astro

Place files in public/ and update your base layout:

<head>
  <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
  <link rel="icon" type="image/x-icon" href="/favicon.ico" />
  <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
  <link rel="manifest" href="/site.webmanifest" />
</head>

Browser Compatibility

BrowserIcon Format Used
Chrome, Edge, FirefoxSVG (preferred) or PNG
SafariPNG favicon or Apple touch icon
Safari (iOS)apple-touch-icon.png
IE 11favicon.ico
Windows (pinned)mstile-150x150.png via browserconfig

Testing Checklist

After installation, verify your icons work correctly:

  • Browser tab: Icon appears in the browser tab
  • Bookmarks: Icon shows when bookmarking the page
  • PWA install: Icon appears in the install prompt (Chrome/Edge)
  • iOS "Add to Home Screen": Apple touch icon appears
  • Windows pinned site: Tile icon appears in Start menu

Troubleshooting

Icon not updating?

Browsers cache favicons aggressively. Try:

  1. Hard refresh: Ctrl+Shift+R (Windows/Linux) or Cmd+Shift+R (Mac)
  2. Clear browser cache
  3. Open in incognito/private mode
  4. Add a cache-busting query: favicon.ico?v=2

PWA icon not showing?

  1. Ensure site.webmanifest is served with correct MIME type (application/manifest+json)
  2. Check browser DevTools → Application → Manifest for errors
  3. Verify icon paths are absolute (start with /)

Apple touch icon not working?

iOS Safari requires the exact filename apple-touch-icon.png in the root or the explicit <link> tag. Both are included in this bundle.

On this page