Generated package

Pelican favicon package. Ready to install.

Download the correct Pelican favicon package, place every file in the right location, and follow the exact installation steps for this stack.

Stack-specific filesExact snippet locationsCopy-ready guide
Static Site Generators9 files

Pelican

For Pelican. Files are copied from content/extra/ to the output root using EXTRA_PATH_METADATA.

ZIP: favico-pelican-modern-package.zip

Folder: favico-pelican-modern-favicon/

  1. 1
    Download your favicon package.
    Download favico-pelican-modern-package.zip for Pelican.
  2. 2
    Extract this package in your project.
    Extract it in your project root. The package contains:
    Package structure
    favico-pelican-modern-favicon/
├── content/extra/favicon.ico
├── content/extra/favicon.svg
├── content/extra/favicon-dark.svg
├── content/extra/favicon-96x96.png
├── content/extra/favicon-dark-96x96.png
├── content/extra/apple-touch-icon.png
├── content/extra/site.webmanifest
├── content/extra/web-app-manifest-192x192.png
└── content/extra/web-app-manifest-512x512.png
  3. 3
    Copy the favicon files to the correct location.
    Copy the generated files to content/extra/.
    Generated fileCopy toStatusPurpose
    favicon.icocontent/extra/favicon.icoOptionalOptional classic browser fallback file. Keep it when useful, but do not link it by default in modern light/dark favicon snippets.
    favicon.svgcontent/extra/favicon.svgRequiredLight-mode SVG favicon for modern browsers.
    favicon-dark.svgcontent/extra/favicon-dark.svgOptionalDark-mode SVG favicon used with prefers-color-scheme: dark.
    favicon-96x96.pngcontent/extra/favicon-96x96.pngRequiredLight-mode PNG fallback favicon.
    favicon-dark-96x96.pngcontent/extra/favicon-dark-96x96.pngOptionalDark-mode PNG fallback favicon.
    apple-touch-icon.pngcontent/extra/apple-touch-icon.pngRequirediPhone/iPad home screen icon.
    site.webmanifestcontent/extra/site.webmanifestRequiredWeb app manifest containing app metadata and PWA icon references.
    web-app-manifest-192x192.pngcontent/extra/web-app-manifest-192x192.pngRequired192×192 Android/PWA icon referenced by the web app manifest.
    web-app-manifest-512x512.pngcontent/extra/web-app-manifest-512x512.pngRequired512×512 Android/PWA icon referenced by the web app manifest.
  4. 4
    Add the config snippet in pelicanconf.py.
    pelicanconf.py
    STATIC_PATHS = ["extra"]

EXTRA_PATH_METADATA = {
    "extra/favicon.ico": {"path": "favicon.ico"},
    "extra/favicon.svg": {"path": "favicon.svg"},
    "extra/favicon-dark.svg": {"path": "favicon-dark.svg"},
    "extra/favicon-96x96.png": {"path": "favicon-96x96.png"},
    "extra/favicon-dark-96x96.png": {"path": "favicon-dark-96x96.png"},
    "extra/apple-touch-icon.png": {"path": "apple-touch-icon.png"},
    "extra/site.webmanifest": {"path": "site.webmanifest"},
    "extra/web-app-manifest-192x192.png": {"path": "web-app-manifest-192x192.png"},
    "extra/web-app-manifest-512x512.png": {"path": "web-app-manifest-512x512.png"},
}
  5. 5
    Insert the favicon/head snippet in theme/templates/base.html inside <head>.
    theme/templates/base.html inside <head>
    <meta name="color-scheme" content="light dark">

<link rel="icon" type="image/svg+xml" href="/favicon.svg?v=10" media="(prefers-color-scheme: light)">
<link rel="icon" type="image/svg+xml" href="/favicon-dark.svg?v=10" media="(prefers-color-scheme: dark)">

<link rel="icon" type="image/png" sizes="96x96" href="/favicon-96x96.png?v=10" media="(prefers-color-scheme: light)">
<link rel="icon" type="image/png" sizes="96x96" href="/favicon-dark-96x96.png?v=10" media="(prefers-color-scheme: dark)">

<link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png?v=10">
<link rel="manifest" href="/site.webmanifest?v=10">
  6. 6
    Why this setup works.
    • Pelican needs EXTRA_PATH_METADATA to copy files from content/extra/ to the generated site root.
    • The theme base template controls the final HTML head.

  7. Support Favico Studio

    Satisfied with the result?

    If Favico Studio helped you create your favicon faster, you can support the creator and help keep this tool free, fast, and available for everyone.

    ♥Support the creator→
  8. 7
    Start your app and verify the favicon URLs.
    Run command
    pelican content && pelican --listen
    Verify URLs
    http://localhost:8000/favicon.svg
http://localhost:8000/site.webmanifest
  9. 8
    Common mistakes to avoid.

    Using the source folder name in the browser URL

    Wrong: /public/favicon.svg or /static/favicon.svg

    Correct: /favicon.svg

    Most frameworks copy public/static assets to the website root. The browser should usually request the root URL, not the source folder name.

    Making favicon.ico the main favicon

    Wrong: <link rel="icon" href="/favicon.ico">

    Correct: Use SVG and PNG links with light/dark media queries.

    favicon.ico is included as an old-browser fallback, but actively linking it can override the modern light/dark setup.

  10. 9
    Final checklist.
    ✓ Correct stack selected.
    ✓ Correct package downloaded and extracted.
    ✓ Files copied to the exact folder shown in this guide.
    ✓ Config snippet added only when this stack requires it.
    ✓ Head/favicon snippet added to the exact head location shown in this guide.
    ✓ No /public/ or /static/ URL is used unless the framework explicitly requires it.
    ✓ favicon.ico is kept as fallback only, not actively linked as the main favicon.
    ✓ favicon.svg loads directly.
    ✓ favicon-dark.svg loads directly.
    ✓ site.webmanifest loads directly.
    ✓ Manifest icon PNG files load directly.
    ✓ Browser cache cleared and Favico Studio checker passes.