PIING
Reading Piing: AlertsAppearance and branding
Piing: Alerts
- Getting started with Piing: Alerts
- Appearance and branding
- Create and manage notifications
- A/B testing
- Frequency capping and suppression
- AI notifications
- Web push
- Segments and audiences
- Signed-in vs signed-out targeting
- Automations
- Analytics and suggestions
- Integrations and data
- FAQ and troubleshooting
- Plans and billing
In this guide
- Brand presets
- Placement lives in the theme editor
- Feed presentation
- It matches your theme before you touch anything
- Icon and badge
- Branding colours
- Copy and behaviour
- Teasers
- Web push opt-in
- Preview
Search or browse documentation
Piing: Alerts 2 / 14
Appearance and branding
Restyle the bell and feed from the admin with no theme edits, including the drawer, popover, modal and sheet presentations, icon, colours, teasers, and copy.
Everything visual ships with the feed, so changes go live the moment you Save, with no theme code to touch. Open Appearance in the admin.
Brand presets
Three starting points fill the palette and corner radius: Éditorial (mono, sharp corners), Studio (warm, soft), Noir (dark). A preset is a starting point. Every value stays editable afterward.
Placement lives in the theme editor
Where the bell sits is set against your live theme, in Shopify's theme editor under App embeds, then Piing: Alerts. That is the single source of truth, and the Appearance page has an Open theme editor button that takes you straight there. You choose:
- Header icons (auto): the bell is inserted into your theme's icon row (search, account, bag) and sized to match its neighbours. This is the default.
- A floating corner bell, in any of the four corners.
- A custom CSS selector, for a header that auto-detection cannot find.
- Its position among the header icons, its size, what happens on mobile when the icons collapse behind a hamburger, and inline or target embedding for account pages and drawers.
If a selector doesn't match, or no icon row can be found, the bell falls back to floating, so a wrong guess never breaks the page.
Everything else on the Appearance page, branding, feed presentation, animations and copy, applies wherever the bell ends up.
Feed presentation
Choose how the panel opens, separately for desktop and mobile. The feed content is identical in every style; only the container changes.
On desktop:
- Drawer: slides in from the edge, full height, with a scrim. Set the side (Right / Left) and the width in px.
- Popover: a compact panel anchored under the bell.
- Modal: a centred dialog with a scrim.
On mobile:
- Full-screen sheet.
- Bottom sheet, which slides up to a partial height with a grab handle.
- Popover, an anchored box.
Two more controls sit with them:
- Panel max height (px) caps the popover, modal, and bottom sheet. It is always kept inside the viewport, so a tall value never overflows.
- When a notification is tapped: open a detail page inside the panel with a back arrow, or expand the detail inline like an accordion. Only applies to cards that carry detail content.
The closed feed never gets in your way. The panel is drawn in its correct closed state before it enters the page, so there is no flash of an unstyled box on first load, and it stops accepting clicks while closed, so it can never sit invisibly over your content and swallow taps.
It matches your theme before you touch anything
On first paint the bell measures the icons already in your header and draws itself to match. It reads how large each glyph is actually painted rather than how large its box is, how heavy the line is, whether the set is outlined or filled, what colour the icons resolve to, how far apart they sit, and whether they all wear the same tinted tile. Then it draws itself at those numbers. On a theme with a sticky header that repaints as you scroll, it re-reads the colour and follows.
The feed panel does the same with type and colour. It takes the page's own base font size, bounded by the visitor's own browser text-size setting, so a theme that sets a tiny root font size does not shrink the feed and a shopper who has asked for larger text gets it. Panel background and text are adopted from the theme as a pair or not at all, and only when the contrast between them clears the accessibility floor. Corner radius is the median of your own buttons and cards.
Anything you set yourself always wins. Every measured property has an independent override under Match my theme, including six named stroke weights from hairline to solid, so where you disagree with the measurement you say so and it stops measuring that one thing.
Icon and badge
- Icon: ten presets, each drawn on one grid at one weight, in both an outline and a solid cut: Bell, Bell with badge, Tag, Star, Heart, Gift, Sparkle, Envelope, Bag, Chat. Or Custom, which takes inline SVG or an image URL.
- The cut is chosen for you: on a theme whose icons are filled, the bell uses its solid form. A tick and a cross have no honest filled form, so those two stay outlined and let the measured weight do the work.
- Icon can also be set per theme, in the theme editor, where the first option is From my Piing: Alerts settings.
- Badge style: Unread count, Dot, or None. The bubble takes the header's own ink, and the numeral inside it only takes the header ground if it clears 3:1 against it, otherwise white or near-black.
- Text label (optional), for example
Notifications, with a Label only (no icon) option.
- Pulse animation on new notifications.
On a narrow phone the bell is measured where it and its count bubble actually landed, against the header's own content box capped by the viewport, and pulled back inside if any of it would sit outside. The box may overhang; nothing a shopper can see is allowed to.
Branding colours
Set nine colours to match your storefront: accent and icon, badge background, badge text, panel background, panel text, muted text, borders, CTA background, CTA text. Each has a hex field and a colour picker.
- Font family:
inherit adopts your theme font, or set any CSS font-family value.
- Corner radius (px).
Copy and behaviour
- Panel title, Empty state title, Empty state body.
- Show timestamps.
- Show "Mark all as read".
- Hide bell when feed is empty.
- Auto-open on first visit.
Teasers
A teaser is a small toast that surfaces a notification without the visitor opening the feed. Mark a card as a teaser in its editor, then tune the global behaviour here:
- Enable teasers.
- Delay (seconds) before it appears.
- Auto-hide after (seconds),
0 to keep it until dismissed.
- Max per session.
The newest teaser-marked notification is the one that peeks out.
Web push opt-in
When browser push is available, this page controls new sign-ups and the prompt shown in the feed footer. Public cards using the Everyone audience can separately opt into a broadcast. Targeted cards remain on-site. Turning off new sign-ups does not revoke existing browser permissions. See Web push.
Preview
The right pane shows the header mount and the open feed, drawn live from your settings. Save, and it matches the storefront exactly.
Why it matters: the look of the widget lives here and the position lives in the theme editor. Neither needs a developer, and neither touches your theme code.
Related guides
Was this guide helpful?
Next guide in Piing: Alerts
Create and manage notifications
Build notification cards with layouts, audiences, scheduling, teasers, pinning, in-feed capture, and statuses.
Still need a hand? Contact us