View .md

Complete Guide to Emoji Favicons

Everything you need to add emoji favicons to any website, app, or project. One line of HTML, 3,773 emojis, zero setup.

Quick Start

Add an emoji favicon to your website in under 60 seconds. No design tools, no image files, no signup needed. Just add one HTML tag:

<link rel="icon" href="https://emoji.findutils.com/fire">

Replace fire with any emoji name: rocket, heart, star, globe, sparkles, or any of 3,773 Unicode emojis. The favicon is served as a lightweight SVG (under 200 bytes) from 300+ edge locations worldwide.

Tip: Browse all 3,773 emojis on the homepage or search by keyword with the Search API.

Customization Options

Customize your emoji favicon with URL parameters. All parameters are optional and can be combined:

<link rel="icon" href="https://emoji.findutils.com/fire?size=64&bg=1a1a1a&shape=circle&animate=pulse">
ParameterValuesExample
size16-512 (pixels)?size=64
bgHex color (no #)?bg=1a1a2e
shape16 shapes: circle, hexagon, shield, star, heart, diamond...?shape=circle
animate27 animations: pulse, bounce, spin, shake, float, flip...?animate=pulse
theme18 themes: github-dark, vercel, tailwind, react, vue...?theme=github-dark
gradient12 presets or custom hex pair?gradient=sunset
badge1-99 or "dot"?badge=3

See full documentation for all 50+ parameters and endpoints.

Framework Integration Guides

Emoji favicons work with every web framework. Here are copy-paste snippets for popular frameworks:

HTML

Add to your <head> section:

<!DOCTYPE html> <html> <head> <link rel="icon" href="https://emoji.findutils.com/rocket" type="image/svg+xml"> <link rel="apple-touch-icon" href="https://emoji.findutils.com/apple-touch-icon/rocket?bg=0a0a0a"> </head>

React (Create React App / Vite)

In your index.html:

<!-- Replace the default favicon link in public/index.html --> <link rel="icon" href="https://emoji.findutils.com/rocket" type="image/svg+xml">

For dynamic favicons with the JavaScript SDK:

<script src="https://emoji.findutils.com/sdk.js"></script> <script> EmojiFavicon.set('rocket'); // Change on events: EmojiFavicon.set('check-mark'); // on success EmojiFavicon.animate('fire', 'pulse'); // animated EmojiFavicon.notify('bell', 3000); // notification badge </script>

Next.js

In app/layout.tsx (App Router):

export const metadata = { icons: { icon: 'https://emoji.findutils.com/rocket', apple: 'https://emoji.findutils.com/apple-touch-icon/rocket?bg=000000', }, };

Or in pages/_document.tsx (Pages Router):

<Head> <link rel="icon" href="https://emoji.findutils.com/rocket" type="image/svg+xml" /> </Head>

Vue / Nuxt

In index.html (Vue) or nuxt.config.ts (Nuxt):

// nuxt.config.ts export default defineNuxtConfig({ app: { head: { link: [ { rel: 'icon', href: 'https://emoji.findutils.com/rocket', type: 'image/svg+xml' } ] } } })

Astro

In your layout or <head>:

--- // src/layouts/BaseLayout.astro --- <html> <head> <link rel="icon" href="https://emoji.findutils.com/rocket" type="image/svg+xml" /> </head>

WordPress

Add to your theme's functions.php:

function emoji_favicon() { echo '<link rel="icon" href="https://emoji.findutils.com/rocket" type="image/svg+xml">'; } add_action('wp_head', 'emoji_favicon');

Shopify

In theme.liquid, add inside <head>:

<link rel="icon" href="https://emoji.findutils.com/shopping-bags" type="image/svg+xml">

Hugo

In your baseof.html layout:

<link rel="icon" href="https://emoji.findutils.com/rocket" type="image/svg+xml">

Advanced Features

Animated Favicons

Add eye-catching animations to your favicon. 27 animation types available:

<link rel="icon" href="https://emoji.findutils.com/fire?animate=pulse"> <link rel="icon" href="https://emoji.findutils.com/rocket?animate=bounce"> <link rel="icon" href="https://emoji.findutils.com/star?animate=spin">

Notification Badges

Show a count badge on your favicon (great for chat apps, inboxes, dashboards):

<link rel="icon" href="https://emoji.findutils.com/bell?badge=5"> <link rel="icon" href="https://emoji.findutils.com/envelope?badge=dot">

Dark Mode Support

Show different emojis based on the user's color scheme preference:

<link rel="icon" href="https://emoji.findutils.com/sun?darkmode=moon">

This shows a sun emoji in light mode and automatically switches to a moon in dark mode.

Combo Emojis

Combine up to 10 emojis side by side:

<link rel="icon" href="https://emoji.findutils.com/fire+rocket+star">

Pixel Art Mode

Get retro 8-bit pixel art versions of any emoji with 16 color palettes:

<link rel="icon" href="https://emoji.findutils.com/pixel/fire?palette=retro">

Browse all 170+ pixel art icons in the Pixel Gallery.

Favicon Formats Explained

Emoji favicons support three output formats. Here is when to use each:

FormatSizeBrowser SupportBest ForHow to Use
SVG (default)<200 bytesChrome, Firefox, Edge, Safari 12+Modern websites, smallest size/fire or /fire?svg
PNG~2-5 KBAll browsersMaximum compatibility, email signatures/fire?png
ICO~15-20 KBAll browsers including IELegacy support, Windows desktop/fire.ico or /fire?format=ico
Recommendation: Use SVG (default) for modern websites. Add a PNG fallback for email clients. Use ICO only if you need IE/legacy support.

Favicon Sizes Reference

Different platforms expect different favicon sizes. Here is the complete reference:

PlatformSizeFormatUsage
Browser tab16x16, 32x32SVG, PNG, ICO/fire?size=32
iOS home screen180x180PNG/apple-touch-icon/fire
Android Chrome192x192, 512x512PNGVia /manifest/fire
Windows tile150x150, 310x310PNG/fire?size=310&png
macOS Safari pinned tabAnySVG/fire?svg
Social media / OG image1200x630SVG/fire?og=true

Use the download endpoint to get a ZIP package with all sizes pre-generated.

PWA & Mobile Support

Emoji favicons include full PWA (Progressive Web App) and mobile support:

<!-- Complete favicon setup for all platforms --> <link rel="icon" href="https://emoji.findutils.com/rocket" type="image/svg+xml"> <link rel="icon" href="https://emoji.findutils.com/rocket?size=32&png" sizes="32x32" type="image/png"> <link rel="apple-touch-icon" href="https://emoji.findutils.com/apple-touch-icon/rocket?bg=0a0a0a"> <link rel="manifest" href="https://emoji.findutils.com/manifest/rocket?name=My+App&color=3b82f6">

The /manifest/ endpoint auto-generates a complete manifest.json with all icon sizes for PWA install.

JavaScript SDK

For dynamic favicon control, use the JavaScript SDK (43 lines, no dependencies):

<script src="https://emoji.findutils.com/sdk.js"></script> <script> // Set favicon EmojiFavicon.set('rocket'); // Animated favicon EmojiFavicon.animate('fire', 'pulse'); // Notification badge (auto-removes after 3 seconds) EmojiFavicon.notify('bell', 3000); // Cycle through emojis EmojiFavicon.cycle(['rocket', 'fire', 'star'], 2000); // Countdown timer EmojiFavicon.countdown('2026-12-31', 'party-popper'); // Search emojis const results = await EmojiFavicon.search('happy'); // Change on blur/focus EmojiFavicon.onBlur('sleeping-face'); EmojiFavicon.onFocus('rocket'); </script>

The SDK provides 22+ methods for dynamic favicon control. See SDK documentation.

Troubleshooting

Favicon Not Showing

If your emoji favicon does not appear:

  1. Clear browser cache - Browsers cache favicons aggressively. Hard refresh with Ctrl+Shift+R (Cmd+Shift+R on Mac).
  2. Check the link tag - Make sure rel="icon" is in your <head>, not <body>.
  3. Remove old favicon.ico - If you have a favicon.ico in your root directory, browsers may prefer it over the link tag.
  4. Check the emoji name - Visit https://emoji.findutils.com/your-emoji-name directly. If you get a 404, try the Search API to find the correct name.
  5. Safari requires PNG - Safari does not always display SVG favicons in the tab. Add a PNG fallback: <link rel="icon" href="/fire?png" type="image/png">
  6. Use the checker - Run your site through the Favicon Health Checker for a complete diagnostic.

Safari Compatibility

Safari has limited SVG favicon support. For best results on Safari, add both SVG and PNG:

<link rel="icon" href="https://emoji.findutils.com/fire" type="image/svg+xml"> <link rel="icon" href="https://emoji.findutils.com/fire?png&size=32" type="image/png" sizes="32x32">

Cross-Origin Issues

Emoji favicons are served with proper CORS headers and work cross-origin. If you see CORS errors, ensure you are using https:// (not http://).

API Integration

For programmatic use, emoji.findutils.com offers a full REST API:

Search API

Search emojis by name or keyword. Returns up to 20 results.

GET /api/search?q=fire

Suggest API

Get emoji suggestions for a topic or URL.

GET /api/suggest?text=cooking+blog

All Emojis

Full catalog of 3,773 emojis with categories.

GET /api/emojis

Color Palette

Extract dominant colors from any emoji.

GET /api/palette/fire

See the full API documentation for all 50+ endpoints, or integrate via OpenAPI 3.1, AI Skill Manifest, or ChatGPT Plugin.

Frequently Asked Questions

Is the emoji favicon service free?

Yes, completely free with no signup, no API key, and no usage limits for normal use. Rate limited at 300 requests per minute per IP.

How fast are emoji favicons served?

SVG favicons are under 200 bytes and served from 300+ edge locations. After the first request from your region, responses come from cache with zero origin latency (typically under 5ms).

Can I use emoji favicons in production?

Yes. The service is built on a global edge network with 99.9%+ uptime. CDN cache ensures your favicon loads even during origin maintenance. Many production websites use emoji favicons.

Do emoji favicons affect my site's SEO?

Yes, positively. Google displays favicons in search results. An emoji favicon is distinct and recognizable, potentially improving click-through rates. The SVG format is fast-loading which helps Core Web Vitals.

Can I self-host the emoji favicons?

Yes. Use the download endpoint to get a ZIP with all sizes (SVG, PNG 16/32/180/512, ICO). Then host the files yourself. You can also use the sprite sheet endpoint to download all emojis at once.

How many emojis are available?

All 3,773 standard Unicode emojis are available, searchable by 11,550 keywords. This includes smileys, people, animals, food, travel, activities, objects, symbols, and flags.