Smart App Banner

On this page 7

A Smart App Banner is a native promotional banner in Safari on iOS and iPadOS that a website enables with a single meta element, inviting visitors to open the site’s companion app or to get it from the App Store. In mobile web practice, it is the standard, system-rendered way to connect a mobile website with its native app without building a custom pop-up or interstitial.

Because Safari draws the banner itself, it shows real App Store data, such as the app icon, name, rating and price, and it knows whether the app is already installed. The visitor sees Open when the app exists on the device and View or Get when it does not, and the page itself needs no JavaScript at all.

How Safari renders a Smart App Banner

A Smart App Banner appears when Safari finds a meta element named apple-itunes-app in the document head. Its content attribute carries the numeric App Store ID of the app, and Safari uses that ID to look up the listing and render a compact bar at the top of the page, above the web content.

Safari performs the installed-app check on the device, so the website learns nothing about which apps the visitor has. When the visitor closes the banner, Safari remembers the choice and suppresses it for that site for a period, which prevents the banner from becoming repetitive or intrusive. The banner also stays hidden when the app is not available in the visitor’s storefront or on that device type.

The attributes that the meta element accepts are listed below.

ParameterRequiredPurpose
app-idYesIdentifies the App Store listing to display
app-argumentNoPasses a URL or context string to the app on open
affiliate-dataNoCarries an affiliate token for attribution
Parameters of the apple-itunes-app meta element

Deep linking with the app-argument parameter

The app-argument parameter turns a Smart App Banner from a generic install prompt into a contextual deep link. When the app is already installed and the visitor taps Open, iOS launches the app and hands over the argument, typically the URL of the current page, so the app can show the same article, product or listing instead of its home screen.

The app must parse the argument itself, usually in the URL-handling or user activity methods of its app delegate or scene delegate. If the app ignores the value, the visitor lands on the start screen and loses context, which is the most common reason why banners deliver poor engagement after the tap. Teams should update the argument on every page and test each route type separately.

Smart App Banners differ from Universal Links, which open the app directly when a user taps a link to the domain. The two mechanisms complement each other: Universal Links handle navigation from other apps and messages, while the banner serves visitors who are already reading the website in Safari.

Smart App Banner compared with other app promotion methods

A Smart App Banner is one of several ways to move mobile web visitors to an app, and it is the least disruptive option. Custom JavaScript banners and full-screen interstitials can be styled freely and work in every browser, but they cover content, add page weight and risk search ranking penalties for intrusive interstitials.

The table below compares the main options from the perspective of a mobile web team.

MethodPlatformsCustomizationMain drawback
Smart App BannerSafari on iOS and iPadOSNoneSafari only
Custom web bannerAll browsersFullNeeds code and upkeep
Full-screen interstitialAll browsersFullBlocks content, hurts trust
Universal LinksiOS apps and SafariNot visualNo install prompt
Related applications in a manifestChromium browsers on AndroidLimitedBrowser decides when to show
Ways to promote a native app from a website

On Android, there is no direct equivalent. Chromium-based browsers can recognize a native app listed under related_applications in the web app manifest, and Android App Links play the role of Universal Links. Many teams therefore combine a Smart App Banner on iOS with a lightweight custom banner on Android.

When to use a Smart App Banner

A Smart App Banner fits sites where the native app offers a clearly better experience for returning users, such as banking, retail, travel booking, news subscriptions and streaming. It is less suitable when the website is the primary product, because constant app promotion can pull users away from conversions that would have happened on the web.

The decision table summarizes typical situations.

SituationRecommendationReason
App adds offline use or notificationsEnable with deep linksClear value for repeat visitors
Checkout flow on the webHide on payment pagesAvoid distraction at conversion
App lacks content shown on the siteUse a generic argumentPrevent dead-end deep links
Progressive web app is the main productUsually omitAvoid competing install prompts
Landing page from paid campaignsTest before enablingEffect on conversions varies
Choosing whether to enable the banner

Because the banner is controlled per page, teams can add the meta element only to selected templates, for example article and product pages, and leave it out of sign-up or payment flows.

Limitations and common mistakes

The main limitation is reach: the banner appears only in Safari, not in third-party browsers on iOS, in-app web views or desktop browsers. Its appearance cannot be styled, its text cannot be changed, and the website receives no event when the visitor taps or dismisses it, so measurement relies on campaign parameters or attribution inside the app.

Typical implementation problems and their fixes are shown below.

SymptomLikely causeFix
Banner never appearsWrong app ID or app not in storefrontVerify the ID and availability
Banner disappeared after testingTester dismissed it earlierTest on a fresh device or profile
App opens on home screenArgument not handled in appImplement routing for the argument
Two install prompts at onceCustom banner also shownSuppress the custom banner in Safari
Banner hides site headerFixed header ignores banner heightTest layouts with the banner visible
Symptoms, causes and fixes

A Smart App Banner should not be confused with an App Clip card, which Safari can show for an App Clip through a separate meta parameter and which launches a small part of an app without full installation.

Put simply

A Smart App Banner is a small strip at the top of a website in Safari that says the site also has an app. If the app is already on your iPhone, the strip offers to open it. If not, it offers to take you to the App Store.

It works like a polite sign at a shop door pointing to the shop’s own entrance around the corner. The key point is that Apple draws the strip, not the website, so it looks the same everywhere, is easy to close and never covers the whole page.

In practice

A regional train operator runs both a mobile website and an iOS app for buying tickets. Its web team adds the apple-itunes-app meta element to timetable and route pages, with app-argument set to the current route URL, but leaves it out of the web checkout so that buyers are not distracted while paying.

The app developers add routing so that a URL for the Prague to Brno route opens the same route screen inside the app, already filled in. After three months, in-app attribution shows that sessions started from the banner reach the ticket screen far more often than sessions started from the app icon, and the team keeps the setup as its standard bridge between web and app for Safari users, while Android visitors see a simple custom banner instead.