Favicon Generator Documentation¶
Menu Location: Settings > Settings > Favicon Generator
Access Level: Administrator and above
Last Updated: 2026-03-01
Overview¶
The Favicon Generator automatically creates all required favicon sizes and formats for your website from a single uploaded image. Favicons are the small icons that appear in browser tabs, bookmarks, and mobile device home screens, providing essential brand recognition for your website.
Primary Functions:
- Upload single high-resolution image and generate all favicon sizes automatically
- Create favicons in multiple formats (ICO, PNG, SVG)
- Generate Apple Touch icons for iOS devices
- Create Android/Chrome app icons
- Set site manifest colors for mobile browsers
- Generate SVG favicon from existing PNG
Page Layout¶
Left Column - Upload & Settings¶
Upload Favicon Image Section:
- File upload field (accepts images)
- "Upload" button
- Requirements: Minimum 512x512px square image
Set Site Manifest Icon Colors:
- theme_color picker - Primary brand color for mobile browser chrome
- background_color picker - Background color for app icon
- Live preview showing how colors look
- "Save Colors" button
Generate SVG from Existing PNG:
- Button to convert existing 512px PNG to SVG format
- Shows current SVG status (exists or not found)
- One-click SVG generation
Right Column - Generated Favicons¶
ICO Format Section:
- Displays all .ico format favicons
- Sizes: 16x16, 32x32, 48x48
PNG Format Section:
- Displays all .png format favicons
- Sizes: 57x57, 60x60, 72x72, 76x76, 114x114, 120x120, 144x144, 152x152, 180x180, 192x192, 512x512
- Each shows preview and copyable URL
SVG Format Section:
- Vector format favicon (if generated)
- Scalable for all sizes
- Preview and download link
Uploading and Generating Favicons¶
Image Requirements¶
Specifications:
- Minimum size: 512x512 pixels (larger is better)
- Must be square: Equal width and height
- Accepted formats: JPG, PNG, GIF
- Recommended: PNG with transparent background
- Image content: Should be recognizable at small sizes
What Makes a Good Favicon:
- Simple, bold design
- High contrast
- Recognizable at 16x16 pixels
- Works in both light and dark mode
- Represents your brand clearly
Upload Process¶
Steps:
- Prepare square image (minimum 512x512px)
- Click "Choose File" button
- Select image from computer
- Click "Upload" button
- System processes image (may take 30-60 seconds)
- All favicon sizes automatically generated
- Success message displays
- Scroll down to see all generated favicons
What Happens:
- System validates image (must be square, minimum size)
- Creates all necessary favicon sizes automatically
- Saves favicons to theme directory
- Updates site manifest
- Clears cache so changes appear immediately
Setting Manifest Colors¶
What Are Manifest Colors?¶
theme_color:
- Primary color for mobile browser interface
- Shows in Android Chrome address bar
- Used in progressive web app title bar
- Should match your brand primary color
background_color:
- Background for app icon before app loads
- Shows while splash screen displays
- Used when adding site to mobile home screen
- Should complement your brand colors
Setting Colors¶
Steps:
- Click theme_color color picker
- Select your brand primary color
- Click background_color color picker
- Select complementary background color
- Review live preview (shows how icon will look)
- Click "Save Colors" button
- Colors saved and applied to site manifest
Best Practices:
- Use your brand's primary color for theme_color
- Choose high-contrast background_color
- Test how colors look with favicon in preview
- Consider both light and dark mode appearance
Generating SVG Favicon¶
Why Use SVG?¶
Benefits:
- Infinitely scalable (vector format)
- Crisp at any size
- Smaller file size than PNG
- Modern browser support
- Future-proof format
Creating SVG¶
If You Have PNG Favicons:
- Click "Generate SVG" button
- System converts 512px PNG to SVG format
- Success message shows source PNG used
- SVG appears in SVG section below
Requirements:
- Must have 512px PNG favicon already uploaded
- System uses highest quality PNG as source
- Conversion automatic and instant
Common Use Cases¶
Use Case 1: First-Time Favicon Setup¶
Goal: Add favicon to new website
Steps:
- Create square logo image (1024x1024px recommended)
- Save as PNG with transparent background
- Go to Favicon Generator page
- Upload image
- Wait for processing
- Set brand colors in manifest section
- Generate SVG
- View website - favicon now appears in browser tab
Result: Complete favicon implementation
Use Case 2: Update Favicon for Rebrand¶
Goal: Replace old favicon with new logo
Steps:
- Prepare new square logo image
- Upload on Favicon Generator page
- All sizes automatically regenerate
- Set updated brand colors
- Generate new SVG
- Clear browser cache to see changes
Result: Updated favicon across all sizes
Use Case 3: Add SVG for Modern Browsers¶
Goal: Create SVG version without re-uploading
Steps:
- Go to Favicon Generator page
- Verify 512px PNG exists in generated favicons
- Click "Generate SVG" button
- System creates SVG from PNG
- SVG now available for modern browsers
Result: SVG favicon added to existing set
Use Case 4: Optimize for Mobile¶
Goal: Ensure great mobile experience
Steps:
- Upload high-quality square logo (512x512+)
- Set theme_color to brand primary color
- Set background_color to complementary color
- Review preview - how does icon look?
- Adjust colors if needed
- Save colors
- Test on mobile device
Result: Optimized mobile appearance
Use Case 5: Fix Blurry Favicon¶
Goal: Improve favicon clarity
Steps:
- Create new version at higher resolution (1024x1024)
- Ensure image is sharp and high-contrast
- Simplify design if too detailed
- Upload new image
- Review all generated sizes
- Verify clarity at 16x16 size
Result: Clear, crisp favicon at all sizes
Troubleshooting¶
Upload Fails with "Must Be Square" Error¶
Symptoms:
- Error message when uploading
- System rejects image
Solutions:
- Open image in editor (Photoshop, Canva, etc.)
- Crop to square (equal width and height)
- Resize to at least 512x512 pixels
- Save and upload again
Favicon Not Updating on Website¶
Symptoms:
- Uploaded new favicon but old one still shows
- Generated successfully but not appearing
Solutions:
- Clear browser cache (Ctrl+Shift+Delete)
- Try hard refresh (Ctrl+F5)
- View site in private/incognito browser
- Wait 5-10 minutes for CDN cache to clear
- Clear mobile browser cache if testing on phone
Colors Not Showing on Mobile¶
Symptoms:
- Set manifest colors but don't see them
Check:
- Only works on supported browsers (Android Chrome, iOS Safari)
- May need to add site to home screen to see
- Colors subtle - may not be obvious
- Try more contrasting colors
SVG Generation Fails¶
Symptoms:
- "No 512px PNG found" error
- SVG button doesn't work
Solutions:
- Upload favicon images first
- Ensure upload included 512px size
- Check generated favicons section for 512px PNG
- Re-upload original image if 512px missing
Best Practices¶
Image Preparation¶
- Start large - Use 1024x1024px or larger source image
- Keep it simple - Complex designs don't scale well to 16px
- High contrast - Ensure visibility against various backgrounds
- Transparent background - Use PNG with transparency when possible
- Test small - View at 16x16 to ensure recognizability
Color Selection¶
- Match brand - Use established brand colors
- Consider context - How colors look in browser chrome
- Test on device - View on actual mobile device
- Accessibility - Ensure sufficient contrast
- Update seasonally - Can change colors for holidays/events
Maintenance¶
- Update with rebrand - Change favicon when logo changes
- Monitor appearance - Periodically check how it looks
- Test new formats - Adopt SVG and new standards
- Version control - Keep source files for future updates
- Document colors - Record hex codes for brand colors
Things to Avoid¶
- ❌ Using rectangular images (must be square)
- ❌ Too detailed/complex designs
- ❌ Low resolution source images
- ❌ Forgetting to generate SVG
- ❌ Not testing on mobile devices
Quick Reference Card¶
| Task | Action/Location |
|---|---|
| Upload new favicon | Choose file, click Upload button |
| Set brand colors | Use color pickers, click Save Colors |
| Generate SVG | Click "Generate SVG" button (after PNG upload) |
| Preview colors | View live preview box after setting colors |
| Copy favicon URL | Click in URL field below each favicon |
| View all sizes | Scroll down to see ICO, PNG, SVG sections |
| Re-upload | Upload new image (overwrites all sizes) |
| Test on mobile | Set colors, add site to phone home screen |
FAQs¶
What size image should I upload?¶
Minimum 512x512px, but 1024x1024px or larger recommended. Must be perfectly square (equal width and height).
Do I need to create each size myself?¶
No! Upload one large square image and the system automatically generates all sizes.
What's the difference between ICO and PNG favicons?¶
ICO is older format for maximum browser compatibility. PNG offers better quality and transparency. System creates both for complete support.
Why do I need so many sizes?¶
Different devices and browsers use different favicon sizes. iOS needs 180x180, Android needs 192x192, desktop browsers use 16x16 to 48x48, etc.
Can I use my logo as favicon?¶
Yes, but simplified logos work better. Complex logos with text or fine details don't scale well to 16x16 pixels.
How do I see the theme colors on mobile?¶
Colors only appear in supported mobile browsers (Android Chrome, iOS Safari). Add your site to home screen to see full effect.
What if my image isn't square?¶
System will reject it. Crop image to square in image editor before uploading.
Should I always generate SVG?¶
Yes! SVG is modern, scalable format supported by all current browsers. Provides best quality at any size.
End of Documentation
For additional help, contact your system administrator or Kiva Logic support.