| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 214 |
| Technical Name |
webapp_customizer |
| License | OPL-1 |
| Website | https://fl1.cz |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Lines of code | 214 |
| Technical Name |
webapp_customizer |
| License | OPL-1 |
| Website | https://fl1.cz |
Company Favicon & PWA Customizer
Transform your Odoo with company-specific favicons and customizable Progressive Web App icons
Key Features
Company-Specific Favicons
Set unique favicons for each company in your multi-company setup. Browser tabs and bookmarks will display the correct company branding automatically.
Progressive Web App Icons
Customize the icon used when users install your Odoo as a Progressive Web App on their devices. Professional branding for mobile experiences.
Automatic Color-Coding
New companies automatically get unique color-coded default favicons, making it easy to distinguish between different company environments.
Dynamic Switching
Favicon automatically changes when switching between companies, providing immediate visual feedback about which company context you're working in.
Seamless Integration
Works perfectly with Odoo 18's native PWA system and integrates cleanly with existing company settings. No conflicts with other modules.
Easy Configuration
Simple setup through familiar Settings interface. Upload icons directly in company settings and PWA configuration. No technical expertise required.
Easy Installation
Activate the Company Favicon & PWA Customizer module from the Apps menu
Progressive Web App Icon Setup
Configure your global PWA icon through the Settings interface. This icon will be used when users install your Odoo instance as a Progressive Web App on their mobile devices or desktops.
- Access Settings: Navigate to Settings from your Odoo interface
- Upload Icon: Select a high-quality PNG image (recommended 512x512 pixels)
- Automatic Scaling: The module automatically generates different sizes (192x192, 512x512) for optimal compatibility
- Instant Application: Changes take effect immediately for new PWA installations
Click the Settings icon to access configuration
Configure your Progressive Web App icon in the General Settings
Company-Specific Favicons
Set unique favicons for each company in your multi-company environment. Perfect for organizations that need to distinguish between different business units, subsidiaries, or brands.
Access company settings through Users & Companies
Upload custom favicons directly in company settings
Professional PWA Installation Experience
When users install your Odoo as a Progressive Web App, they'll see your custom branding throughout the installation process and in their device's app list.
Professional PWA installation experience with your custom icon
Technical Benefits
🔧 Clean Integration
- Seamlessly integrates with Odoo 18's native PWA system
- Uses Odoo's standard attachment system for icon storage
- Inherits WebManifest controller for proper PWA integration
- No conflicts with existing modules or customizations
⚡ Performance Optimized
- Automatic image resizing and caching
- Efficient JavaScript for dynamic favicon switching
- Minimal server load with proper HTTP caching headers
- Uses Pillow library for high-quality image processing
🛡️ Enterprise Ready
- Full multi-company support with isolated favicon settings
- Automatic fallback to default favicon if none configured
- Color-coded default favicons for new companies
- Secure attachment handling with proper access controls
🔄 Future Proof
- Built specifically for Odoo 18
- Follows Odoo development best practices
- Compatible with standard Odoo deployment methods
- Easy to maintain and extend
Perfect For
🏢 Multi-Company Organizations
Distinguish between different business units, subsidiaries, or brands with unique favicons for each company entity.
🎨 Branding-Conscious Businesses
Maintain consistent brand identity across all digital touchpoints, including browser tabs and mobile app installations.
📱 Mobile-First Companies
Provide professional PWA installation experience for users who prefer mobile access to your Odoo system.
🏭 Service Providers
Offer white-label Odoo solutions with client-specific branding for favicons and PWA icons.
🌐 SaaS Platforms
Allow customers to customize their Odoo experience with their own branding elements.
👥 User Experience Teams
Improve user experience by providing visual context clues about which company environment users are working in.
Installation & Setup Guide
📦 Installation Requirements
- Odoo Version: 18.0+
- Python Dependencies: Pillow (included with Odoo)
- Browser Support: All modern browsers
- PWA Support: Chrome, Firefox, Safari, Edge
⚙️ Configuration Steps
- Install Module: Activate from Apps menu
- Configure PWA Icon: Upload in Settings → General Settings
- Set Company Favicons: Configure in Settings → Companies
- Test: Switch companies to verify favicon changes
🎨 Image Specifications
- PWA Icon: PNG format, 512x512 pixels recommended
- Company Favicon: ICO, PNG, or JPG format
- File Size: Maximum 1MB per image
- Quality: High-resolution for best results
🔧 Technical Details
- Storage: Favicon in company record, PWA icon as attachment
- Caching: Automatic browser and server-side caching
- Fallback: Automatic default favicon generation
- Compatibility: Works with all Odoo deployment methods
Professional Support
🎯 Expert Development
Developed by FL1 sro, specialists in Odoo customization with deep understanding of Odoo's PWA and multi-company architecture.
🔧 Lifetime Support
Get ongoing support for installation, configuration, and troubleshooting. We're committed to your success with this module.
🆙 Free Updates
Receive free updates and improvements as we enhance the module and add new features based on user feedback.
Contact: FL1 sro | Website: https://fl1.cz
For technical support, customization requests, or questions about this module, reach out to our team.
Company Favicon & PWA Customizer
Transform your Odoo with professional favicon and PWA icon customization. This module provides comprehensive branding solutions for multi-company environments and Progressive Web App installations.
Table of Contents
Features
🏢 Company-Specific Favicons
- Unique Branding: Set different favicons for each company in multi-company environments
- Automatic Color-Coding: New companies get unique color-coded default favicons automatically
- Dynamic Switching: Favicon automatically changes when switching between companies
- Multi-Company Support: Perfect for distinguishing business units, subsidiaries, or different brands
- Browser Integration: Works with all favicon-related elements (tabs, bookmarks, shortcuts)
📱 Progressive Web App Icons
- Custom PWA Icons: Upload custom icons for Progressive Web App installations
- Multi-Resolution Support: Automatically generates 192x192 and 512x512 pixel versions
- Professional Installation: Users see your custom branding during PWA installation
- Mobile Optimization: Enhanced experience on mobile devices and tablets
- Native Integration: Seamlessly works with Odoo 18's built-in PWA system
⚡ Technical Benefits
- Easy Configuration: Simple setup through familiar Settings interface
- Clean Architecture: Separate company favicons from global PWA icons
- Performance Optimized: Efficient caching and image processing
- Enterprise Ready: Full support for complex multi-company setups
- Automatic Fallbacks: Graceful degradation if custom icons aren't configured
Installation
Requirements
- Odoo Version: 18.0 or higher
- Python Dependencies: Pillow (included with standard Odoo installation)
- Browser Support: All modern browsers (Chrome, Firefox, Safari, Edge)
- PWA Compatibility: Full PWA support in supported browsers
Installation Steps
- Download Module: Purchase and download from Odoo Apps Store
- Upload to Server: Copy module to your Odoo addons directory
- Update Module List: Go to Apps → Update Apps List
- Install Module: Search for "Company Favicon & PWA Customizer" and click Activate
# Alternative: Install via command line
python odoo-bin -c config.conf -d database -i webapp_customizer
Configuration
Progressive Web App Icon Setup
- Access Settings:
- Navigate to Settings from your Odoo home screen
- Click on "General Settings" tab
- Configure PWA Icon:
- Scroll to "Progressive Web App" section
- Click on the "PWA Icon" field
- Upload your custom icon (recommended: PNG format, 512x512 pixels)
- Click "Save"
Note
The PWA icon will be automatically resized to 192x192 and 512x512 pixels for optimal compatibility across devices.
Company Favicon Configuration
- Navigate to Companies:
- Go to Settings → Users & Companies → Companies
- Select the company you want to customize
- Upload Company Favicon:
- Scroll to the "Company Favicon" field
- Upload your favicon image (ICO, PNG, or JPG format recommended)
- Save the company record
- Verify Configuration:
- Switch between companies to see the favicon change automatically
- Check browser tabs and bookmarks for the new favicon
Usage
Daily Operations
Automatic Favicon Switching: When working in multi-company environments, the favicon automatically updates when you switch companies, providing immediate visual feedback about your current context.
PWA Installation: When users install your Odoo as a Progressive Web App:
- Browser displays installation prompt with your custom icon
- App appears on device home screen with your branding
- System app list shows your custom icon and name
New Company Setup: When creating new companies:
- System automatically generates a unique color-coded favicon
- Each company gets a distinct visual identifier
- You can later customize with company-specific branding
Multi-Company Scenarios
Business Units: - Different divisions can have unique favicons - Easy visual distinction between operational units - Consistent branding across all touchpoints
White-Label Solutions: - Service providers can brand Odoo for each client - Custom PWA icons for professional mobile installations - Client-specific favicons for web access
Best Practices
Image Specifications
PWA Icons: * Format: PNG (recommended) * Size: 512x512 pixels (optimal) * Quality: High resolution for crisp display * Design: Simple, recognizable symbol * Background: Solid color or transparent
Company Favicons: * Format: ICO, PNG, or JPG * Size: 16x16, 32x32, or 64x64 pixels * File Size: Under 100KB recommended * Design: Simple, company-representative icon
Configuration Tips
- Consistent Branding: Use similar color schemes between PWA icons and company favicons
- Testing: Test favicon visibility across different browsers and devices
- Backup: Keep original high-resolution images for future updates
- Documentation: Maintain records of which companies use which favicons
Troubleshooting
Common Issues
Favicon Not Appearing * Clear browser cache and cookies * Check if favicon file was uploaded correctly * Ensure file format is supported (ICO, PNG, JPG) * Verify company favicon field is not empty
PWA Icon Not Showing * Confirm PWA icon is uploaded in Settings * Check file format (PNG recommended) * Verify browser PWA support * Test PWA installation process
Company Switching Issues * Check JavaScript console for errors * Verify module assets are loaded correctly * Confirm company switching functionality works * Test with different browsers
Performance Issues * Optimize image file sizes (under 100KB for favicons) * Check server caching configuration * Monitor browser network requests
Technical Details
Storage Locations: * Company favicons: Stored in res.company model * PWA icons: Stored as ir.attachment records * Default favicons: Generated automatically with unique colors
Caching Behavior: * Browser-side caching with appropriate headers * Server-side optimization for repeated requests * Automatic cache busting when images change
JavaScript Integration: * Real-time favicon updates without page refresh * Integration with Odoo's company switching mechanism * Fallback handling for missing favicons
Known Issues / Roadmap
Current Limitations
- PWA icon changes require new PWA installation to take effect
- Some older browsers may have limited favicon format support
- Large favicon files may impact initial page load time
Planned Enhancements
- v18.0.2.0.0: Bulk favicon management interface
- v18.0.3.0.0: Favicon preview in company selection
- Future: Integration with theme customization
- Future: Automatic favicon generation from company logos
Bug Reports
For bug reports and feature requests, please contact FL1 sro support team.
Credits
Authors
- FL1 sro
Contributors
- Development Team at FL1 sro
- Beta testers from the Odoo community
Maintainers
This module is maintained by FL1 sro.
FL1 sro specializes in Odoo customization and provides professional support for complex multi-company environments.
Support
For technical support, customization requests, or questions about this module:
- Website: https://fl1.cz
- Email: Contact through website form
License
This module is licensed under OPL-1 (Odoo Proprietary License).
This is a proprietary commercial module. The license restricts usage to valid Odoo Enterprise subscriptions and allows customization only within the bounds of the OPL-1 license terms.
Changelog
18.0.1.0.0 (2025-08-20)
Added * Initial release * Company-specific favicon support * Progressive Web App icon customization * Automatic color-coded default favicons * Dynamic favicon switching * Multi-company environment support * Integration with Odoo 18 PWA system * Comprehensive documentation * Professional store listing
Technical Features * WebManifest controller inheritance * Efficient image processing with Pillow * Automatic image resizing (192x192, 512x512) * JavaScript-based favicon switching * Proper HTTP caching headers * Fallback mechanisms for missing icons
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module