wordcubiq

Official Add To Homescreen is a WordPress wrapper for the <a href="http://addtohome.cubiq.org" rel="nofollow ugc">Add To Homescreen</a> javascript plugin. This WordPress plugin guides you through the rather complicated javascript widget configuration.
This is the only WordPress plugin developed by the same author of the javascript widget (hence “official”). If you wish to be always up to date and receive the latest bug fixes, this plugin is probably your best bet.
The plugin opens a message inviting the mobile user to add the application to the home screen. This is currently supported on iOS and Mobile Chrome. While other devices have the ability to bookmark any website to the home screen, only iOS and Mobile Chrome have a straightforward way to do it. Windows Phone support is planned for a future release.
To enhance performance and reduce complexity I’m supporting the latest two OS version for each device only.
<h4>Important! Please read</h4>
Add To Homescreen development started when Apple introduced the <code>apple-mobile-web-app-capable</code> meta tag and <code>standalone</code> mode with it. It was a great news for web developers who had the opportunity to release full screen web applications (and not just websites). The script evolved over time and extended to a more general purpose use case.
It is important to note that there’s no native event we could hook to to know when a user actually added the page to the homescreen. That’s also the reason why this script has become so complicated despite the apparent simple task it has to accomplish.
Unless you explicitly developed your application to be <code>mobile-web-app-capable</code>, this script can’t do miracles and all the alternative solutions have to be considered hacks.
The Basic configuration gives you four presets, the only 100% fail-safe solution is to select the Anonymous option. This disables user tracking but it doesn’t interfere with other plugins you may have.
Considering the complexity of the script, before filing a negative feedback, please drop a support request or a bug report. It’s the only way for me to enhance this software. Thanks!
<h3>License</h3>
This WordPress plugin is released under the GPL license. You can use it free of charge for personal and commercial use, but further modifications and derivatives have to be released under the same GPL license.
The Add To Homescreen javascript component is released under <a href="http://cubiq.org/license" rel="nofollow ugc">MIT license</a>, which basically means you can do whatever you want with it.

Official Add to Homescreen

Official Add To Homescreen plugin displays a callout to mobile users inviting them to add the website to the home screen.

Ziyad Bachalany

🌟 Captivate your mobile visitors with a beautiful, customizable prompt on iOS and Android, encouraging them to add your site to their home screen.
🚀 Your site instantly transforms into a fast, smooth Web App, delivering a native-like mobile experience without the cost of building an app.
🛠️ Works seamlessly on both single-site and multisite installations. Network-wide settings are available for consistent configuration across all subsites.
Perfect for blogs, businesses, e-commerce, online courses and WordPress multisite networks.
<h4>📺 Watch the quick video introduction</h4>
<iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/u2h0_h3ct48?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe>
<h4>Why Choose This Plugin?</h4>
<ul>
<li>Engage Mobile Users: Prompt visitors to save your site as an app-like icon on their phone, keeping them coming back.</li>
<li>Cross-Platform Support: Works on Safari and Chrome for iOS, as well as Chrome for Android, ensuring maximum compatibility across mobile devices.</li>
<li>Cost-Effective: Build an app-like experience with WordPress and Progressive Web App (PWA) standards—no need for native iOS or Android app development.</li>
<li>Multisite Ready: Seamlessly applies PWA settings across all subsites in a WordPress multisite network.</li>
<li>Free & Pro Options: Start with robust free features and unlock premium capabilities for advanced customization and analytics.</li>
</ul>
2025 Update: Enhanced performance, improved multisite support, and new Pro features to make your PWA shine! Fully compliant with WordPress standards and optimized for the latest devices.
2026 Update: Fully adapted to the new Safari iOS share sheet flow (iOS 16.4+), which requires additional steps to reach “Add to Home Screen”.
<h4>Free Features</h4>
<ul>
<li>Customizable Floating Balloon: Display a stylish prompt on iOS and Android with tailored messages, animations, and delays.</li>
<li>PWA Basics: Enable core Progressive Web App functionality with a manifest for standalone app-like behavior.</li>
<li>Multisite Support: Customize PWA settings, iOS floating balloon, and Android install button consistently across all subsites in a WordPress network.</li>
<li>Touch Icon: Add a custom icon (192×192 or 512×512 PNG) for the home screen.</li>
<li>Flexible Display Options: Show the balloon on all pages or just the homepage, with settings for returning visitors.</li>
<li>Animations & Timing: Choose from drop, bubble, or fade animations, and set start delays and lifespans.</li>
<li>Built-in Translations: Includes English, French, and German translations, with support for custom message translations via WPML, Polylang, Loco Translate, and more.</li>
<li>Clean Uninstall: Safely remove the plugin with a proper data cleanup option to keep your site tidy.</li>
<li>Lightweight & Fast: Built with performance in mind, using the proven <a href="https://github.com/cubiq/add-to-homescreen" rel="nofollow ugc">Cubiq Add to Home Screen script</a>.</li>
</ul>
<h4>Premium Features (Pro Version)</h4>
🌟 Upgrade to the Pro version at <a href="https://tulipemedia.com/en/product/aths-wordpress-premium/" rel="nofollow ugc">tulipemedia.com</a> for next-level PWA power: 
– Loading Spinner: Display a smooth, customizable loading spinner while your app content loads — fully integrated with your brand colors. 
– Pull to Refresh: Offer users a native-like refresh gesture on your Web App, just like on real mobile apps. 
– Bottom Navigation Bar: Enhance your PWA with a sleek, customizable bottom bar featuring Back, Forward, and Share buttons — for a smoother and more app-like mobile experience. 
– Dashboard PWA Support: Add the WordPress admin dashboard as a web app for quick mobile access — ideal for logged-in users or clients who need fast, app-like access to the WordPress backend. 
– Advanced Prompts: Fine-tune dashboard prompts for iOS and Android, with custom messages and icons. 
– Installation Tracking: Monitor how many users add your PWA to their home screens with detailed stats (GDPR-compliant, anonymized data). 
– Custom Colors & Spinner: Personalize the top bar and loading spinner color for a branded experience. 
– Custom Icons: Upload unique icons for frontend balloons and dashboard prompts. 
– Enhanced Multisite: Manage Pro settings at the network level for consistent PWA behavior across subsites, or customize per subsite for unique configurations. 
– Clean Uninstall: Safely remove the plugin (free and Pro) with a proper data cleanup option to keep your site tidy.
Ready to elevate your PWA? Get Pro now at <a href="https://tulipemedia.com/en/product/aths-wordpress-premium/" rel="nofollow ugc">tulipemedia.com!</a> 🌟
<h4>Demos</h4>
<ul>
<li>Free Version: See it in action on <a href="https://tulipemedia.com" rel="nofollow ugc">tulipemedia.com</a> (load on a mobile device for the full experience).</li>
<li>Pro Version: Experience the Pro version on <a href="https://merco6.com" rel="nofollow ugc">merco6.com</a> (mobile view recommended). You’ll see the custom top bar color and loading spinner in action — both are fully customizable in the Pro version.</li>
<li>Video Demo: Watch the demo video 
<iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/N6bu2aL_CbY?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></li>
</ul>
<h4>Who’s This For?</h4>
<ul>
<li>Bloggers wanting to keep readers engaged on mobile.</li>
<li>Businesses aiming for a native app-like experience without the cost.</li>
<li>Online course creators & educators selling courses or training to engage learners on the go.</li>
<li>Multisite network admins seeking a unified PWA solution.</li>
<li>Content-Driven Businesses—coaches, trainers, content creators, researchers, journalists, educators, and consultants seeking to engage mobile audiences with a seamless Progressive Web App.</li>
</ul>
<h3>Contribute</h3>
<ul>
<li>🌐 Translate: Help make the plugin accessible worldwide! Contribute translations at <a href="https://translate.wordpress.org/projects/wp-plugins/add-to-home-screen-wp/" rel="nofollow ugc">WordPress Translate</a>.</li>
<li>Donate: Support ongoing development with a coffee! ☕ <a href="https://paypal.me/ziyadbachalany" rel="nofollow ugc">Donate now</a>.</li>
<li>Rate Me: Love the plugin? Share a 5-star review on <a href="https://wordpress.org/support/plugin/add-to-home-screen-wp/reviews/#new-post" rel="ugc">WordPress.org</a> to help others discover it.</li>
<li>Follow Me: Stay updated on <a href="https://instagram.com/ziyadbachalany/" rel="nofollow ugc">Instagram</a>, <a href="https://www.linkedin.com/in/ziyadbachalany/" rel="nofollow ugc">LinkedIn</a>, <a href="https://x.com/ziyadbachalany" rel="nofollow ugc">X</a>, <a href="https://www.facebook.com/ziyadbachalany" rel="nofollow ugc">Facebook</a>, or <a href="https://www.youtube.com/channel/UClMfre0hj-UCxGocDleZxTQ" rel="nofollow ugc">YouTube</a>.</li>
</ul>
<h3>Credits</h3>
Developed with ❤️ by <a href="https://tulipemedia.com" rel="nofollow ugc">Ziyad Bachalany</a>. Uses the <a href="https://github.com/cubiq/add-to-homescreen" rel="nofollow ugc">Cubiq Add to Home Screen script</a> by Matteo Spinelli (MIT License).
<h3>Support</h3>
Need help? Visit our <a href="https://tulipemedia.com/en/add-to-home-screen-wordpress-plugin/" rel="nofollow ugc">support page</a> for documentation, FAQs, and contact options. Upgrade to the Pro version at <a href="https://tulipemedia.com/en/product/aths-wordpress-premium/" rel="nofollow ugc">tulipemedia.com</a>.
<h3>License</h3>
This plugin is licensed under GPLv2 or later. The included Cubiq Add to Home Screen script is released under the MIT License:
MIT License for Cubiq Script 
Copyright (c) 2013 Matteo Spinelli, https://github.com/cubiq/add-to-homescreen 
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: 
The above copyright notice and this permission notice shall 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.

Add to Home Screen & Progressive Web App

I reported a bug a year ago, but it hasn't been fixed yet:
https://wordpress.org/support/topic/plugin-is-throwing-an-error?replies=1
To fix this, the addmetawebcapablelinks() function simply needs to moved to another area. Moving it to the top of the file is sufficient to fix the problem. If this error is fixed, I'll bump my rating up higher, but in it's current state this plugin is not usable IMO.



Broken: Throws PHP error

The plugin works perfectly on ioS devices and exactly for that it is described.

One wish of mine would be that this would also work on Android devices when using the Samsung browser or the Firefox browser. With the Google Chrome Browser the message for the installation of the PWA is displayed but not in Firefox etc. 

Maybe there will be an update of the plugin in the future where this can be done ;)

Best regards
Joachim

Great Plugin

Didn't work

Turn your WordPress site into a Web App (PWA) with a stylish 'Add to Home Screen' prompt for iOS & Android. Boost engagement without native app costs!

Official Add to Homescreen vs Add to Home Screen & Progressive Web App