Skip to content

App Store Button ​

An app-store download badge: the store logo plus the classic two-line "Download on the / App Store" lockup, linking to a store listing. The badge renders as a real anchor with the theme's contrast tokens, so it stays readable in both appearances without any brand-asset files.

Stores ​

Three stores ship with a badge treatment. Pick one with the store attribute (apple is the default).

PreviewCode
RTL
html
<ore-app-store-button store="apple" href="https://apps.apple.com/app/id1234567890"></ore-app-store-button>
<ore-app-store-button store="google-play" href="https://play.google.com/store/apps/details?id=com.example"></ore-app-store-button>
<ore-app-store-button store="huawei" href="https://appgallery.huawei.com/app/C12345678"></ore-app-store-button>
StoreBadge text
appleDownload on the App Store
google-playGet it on Google Play
huaweiExplore it on AppGallery

Variants ​

filled (the default) renders the classic inverted slab: dark ink in the light appearance, a light slab in the dark one. outline renders a bordered badge drawn with the surrounding text color, so it blends into light and dark sections alike.

PreviewCode
RTL
html
<ore-app-store-button href="https://apps.apple.com/app/id1234567890"></ore-app-store-button>
<ore-app-store-button variant="outline" href="https://apps.apple.com/app/id1234567890"></ore-app-store-button>

Sizes ​

md is the standard 40px badge; lg is the 44px touch-friendly tier.

PreviewCode
RTL
html
<ore-app-store-button size="md" href="https://apps.apple.com/app/id1234567890"></ore-app-store-button>
<ore-app-store-button size="lg" store="google-play" href="https://play.google.com/store/apps/details?id=com.example"></ore-app-store-button>

Linking ​

With href the badge is a native <a>: target and rel pass through, and noopener noreferrer is added automatically whenever target="_blank". Open store links in a new tab so visitors keep your page:

PreviewCode
RTL
html
<ore-app-store-button store="apple" href="https://apps.apple.com/app/id1234567890" target="_blank"></ore-app-store-button>

Without href the badge still renders (useful in build pipelines where the listing URL arrives later), but as an image-role badge: it shows the printed text to screen readers and is not focusable or clickable.

API Reference ​

ore-app-store-button Attributes ​

AttributeTypeDefaultDescription
store'apple' | 'google-play' | 'huawei''apple'Store badge to render
variant'filled' | 'outline''filled'Visual treatment
size'md' | 'lg''md'Badge size (40px / 44px)
hrefstringN/AStore listing URL; the badge is an anchor when set
target'_blank' | '_self' | '_parent' | '_top'N/ALink target (requires href)
relstringN/ALink rel; noopener noreferrer is merged in for target="_blank"
labelstringN/AAccessible label override (defaults to the printed badge text)

Slots ​

None. The badge lockup is fixed by design: it mirrors the store's printed badge.

Events ​

The badge emits no custom events; with href set, the native anchor's click composes out of the shadow DOM as usual.

CSS Parts ​

PartElement
linkThe anchor (href set) or image-role span
logoThe store logo wrapper
labelsThe two-line text lockup wrapper
eyebrowThe small uppercase line ("Download on the")
storeThe store name line ("App Store")

CSS Custom Properties ​

PropertyDescriptionDefault
--app-store-button-filled-bgFilled badge backgroundvar(--color-contrast-900)
--app-store-button-filled-colorFilled badge foregroundvar(--color-contrast-50)
--app-store-button-filled-hover-bgFilled background on hovervar(--color-contrast-800)
--app-store-button-outline-colorOutline badge foregroundvar(--text-color-heading)
--app-store-button-outline-border-colorOutline badge border colorvar(--color-neutral-border)
--app-store-button-outline-hover-bgOutline background on hovervar(--color-neutral-backdrop)
--app-store-button-radiusBadge corner radiusvar(--rounded-lg)
--app-store-button-eyebrow-opacityOpacity of the eyebrow line0.85

To pin the classic pure-black Apple badge regardless of appearance, override the filled tokens:

css
ore-app-store-button {
  --app-store-button-filled-bg: #000;
  --app-store-button-filled-hover-bg: #1a1a1a;
}

Trademarks ​

Apple, the Apple logo, "App Store", Google, "Google Play", Huawei, and "AppGallery" are trademarks of their respective owners. The badge renders the store logo and printed text for the sole purpose of linking to your app's store listing, and the logo path data is the public-domain (CC0) artwork from Simple Icons.

Trademarks are not dedicated to the public domain: each store publishes brand guidelines for its official download badge (official artwork, prescribed colors, minimum sizes). The themed filled/outline treatments here are theme-coherent renderings, not the official assets: if your store agreement or brand guidelines require the official badge, pin the filled tokens to the prescribed colors (for example pure black for the Apple badge, as shown above) or use the store-provided badge image instead. When in doubt, check the current guidelines: Apple, Google Play, Huawei AppGallery.

Accessibility ​

Screen readers: the badge exposes one accessible name matching the printed text ("Get it on Google Play"). The logo and lockup are aria-hidden, so nothing is announced twice. Override the name to name your app (label="Get Quest Tamer on the App Store").

Keyboard: with href the badge is a real anchor in the tab order and shows the shared focus ring on :focus-visible. Without href it is intentionally not focusable.

Contrast: the filled badge pairs the extremes of the contrast ramp (--color-contrast-900 with --color-contrast-50), so it passes contrast requirements in both appearances; the outline badge inherits the surrounding body text color.