User Guide

Product Label & Badges Documentation

Everything you need to install, design badges, set targeting rules, and get the most out of every feature.

Getting Started

Up and running with your first badge in under 5 minutes — no coding required.

1

Install Product Label & Badges from the Shopify App Store

Click Install on the app listing. Approve the requested permissions and you'll be redirected to the badge dashboard inside your Shopify admin.

2

Create your first badge

Click Create Badge on the dashboard. Choose a template from the gallery or start with a blank canvas. Give your badge a name (e.g., "Summer Sale") and open the designer.

3

Design the badge

Use the visual editor to set the badge text, font, fill color or gradient, shape, size, and position. Changes preview live — what you see in the editor is exactly what customers see.

4

Set targeting rules

Go to the Targeting tab within the badge editor. Add one or more rules — by product, collection, tag, inventory level, discount, or date range — to control exactly which products display this badge.

5

Enable the app embed in your theme

In your Shopify admin go to Online Store → Themes → Customize. Click App Embeds in the sidebar and toggle on Product Label & Badges. Save — badges are now live on your store.

The app embed is a one-time setup. All future badge changes, additions, and deletions take effect immediately without revisiting the theme editor.

Badge Designer

Full visual control over how your badge looks — from shape to typography to animation.

Templates gallery
Start from one of 12+ pre-built templates: Sale, New Arrival, Bestseller, Hot, Limited, Free Shipping, Out of Stock, and more. Templates are fully editable after selection.
Fill type
Solid — single flat color. Gradient — two-color linear or radial gradient. Shape — badge rendered as an SVG shape (ribbon, star, circle, hexagon, and 8 more). Image — upload a custom graphic as the badge background (Pro).
Shape library
Choose from 12 built-in SVG shapes including rectangle, rounded rectangle, circle, star, ribbon, banner, shield, hexagon, diamond, starburst, drop, and badge. Each is rendered via CSS clip-path for crisp display at any size.
Text & typography
Set badge label text, font size (px or %), font weight, letter spacing, and text color. Enable Auto-fit text to automatically scale the font so the text always fills the badge without overflow.
Size & responsive
Set badge width and height in px or %. Enable Mobile size override to display a smaller badge on mobile devices without affecting the desktop layout.
Border & corners
Add an optional border with custom width, color, and style. Set individual corner radii for each corner or use a single value for all four.
Padding & margin
Fine-tune internal padding and external margin using the collapsible padding/margin controls. Each side (top, right, bottom, left) can be set independently.
Entrance animations Starter+
Add an entrance animation that plays when the badge first becomes visible: Fade In, Slide In, Bounce, Pulse, or Zoom In. Set animation duration and delay.
Countdown timer inside badge Pro
Embed a live countdown directly inside the badge label (e.g., "Ends in 01:45:22"). Link the timer to a fixed end date or a per-session rolling duration. Automatically hides the badge when the countdown reaches zero.
Image fill Pro
Upload a PNG or SVG as the badge background — your logo, a seasonal graphic, or any custom image. Supports transparency and scales to fit the badge dimensions.
Targeting Rules

Control exactly which products show a badge using one or more rules. Rules are evaluated live on the storefront.

Specific products
Search and select individual products from your Shopify catalog using the product picker. The badge will only appear on the chosen products regardless of any other conditions.
Collections
Target all products in one or more Shopify collections. Includes both manual and smart collections. New products added to the collection are automatically included — no rule update needed.
Product tags
Show the badge on any product that has a specific tag (e.g., on-sale, new-arrival, staff-pick). Multiple tags can be added; the badge appears when any of the tags match.
Inventory status
Dynamically show the badge based on current stock. Options: In Stock, Low Stock (below a configurable threshold), or Out of Stock. Evaluated in real time on every page load.
Discount / compare-at price
Show the badge when a product has a compare-at price set (i.e., it's on sale). Optionally filter by minimum discount percentage — e.g., only show "BIG SALE" when the discount is 20% or more.
New arrivals
Show the badge on products created within the last N days (configurable). Automatically expires the badge once the product is older than the threshold — no manual action needed.
Country restriction Pro
Limit badge display to visitors from specific countries. Useful for region-specific promotions, shipping offers, or compliance requirements.
Rule logic
Multiple rules on a single badge use AND logic by default — all conditions must match. The badge appears when the product satisfies every rule in the set.

Dynamic rules update automatically. Inventory status and discount rules are evaluated fresh on each page load — badges appear and disappear in real time without any manual re-publishing.

Placement & Surfaces

Choose where your badges appear and set different positions per surface.

Product page
Badge overlays the main product image on the product detail page. Position options: top-left, top-right, bottom-left, bottom-right, center, or custom XY offset (Pro).
Collection listing
Badge appears on product image thumbnails in collection and search result grids. Position can be set independently from the product page placement.
Cart page
Badge displays next to the product line item in the cart. Useful for reinforcing urgency labels (e.g., "Only 2 Left") right before checkout.
Custom XY position Pro
Set a precise pixel or percentage offset from any corner for each surface. Allows exact placement for themes with unusual product image layouts or overlapping UI elements.
Per-surface enable / disable
Each surface can be toggled on or off independently per badge. Show a badge on collection grids but hide it on the product page, or vice versa.
Z-index / stacking
If multiple badges target the same product and position, the badge with the higher priority order in the dashboard takes precedence. Drag badges in the list to reorder priority.

Badge positions are relative to the product image container as rendered by your theme. If a badge appears off-center or clipped, try adjusting the XY offset values or check whether your theme applies overflow:hidden to product image wrappers.

Analytics & Click Tracking Pro Plan

Understand which badges are driving engagement and influencing purchase decisions.

1

Analytics are on by default (Pro)

Once you're on the Pro plan, impression and click data is collected automatically for every active badge — no configuration needed. The storefront JS fires events to the analytics queue whenever a badge is viewed or clicked.

2

View the Analytics dashboard

Open the Analytics tab in the app. Each badge is listed with its total impressions (times displayed), clicks, and click-through rate (CTR). Filter by date range to see performance over any period.

3

Use click tracking to link badges

In the badge editor, set a Click URL on any badge. When a customer clicks the badge, they're taken to that URL (e.g., a sale collection, a product page, or a landing page). This click is recorded in Analytics and the badge acts as a direct call-to-action.

Impressions
Counted once per badge per page load. If the same badge appears on 3 products in a collection listing, that counts as 3 impressions.
Clicks
Recorded when a visitor clicks directly on a badge that has a click URL set. Deduped per session to avoid inflated counts from accidental multi-clicks.
Data retention
Analytics data is retained for 90 days on the Pro plan. Older events are automatically purged. Export data from the Analytics tab before it expires if long-term records are needed.
Plans & Pricing

Start free forever. Upgrade to Pro for unlimited badges and advanced features. Pro includes a 7-day free trial.

Free
$0
forever free
5 active badges
Product page placement
9-point preset positioning
All products & specific targeting
Text & image badge types

Billing is handled entirely by Shopify — no separate payment method needed. To upgrade or cancel, go to Plans & Pricing in the app dashboard. Cancellation takes effect immediately with no fees. If you downgrade from Pro to Free, badges above the 5-badge free limit are paused automatically (not deleted) until you re-upgrade.

Troubleshooting

Common issues and how to resolve them quickly.

No badges are showing on my store
Check two things: (1) Go to Online Store → Themes → Customize → App Embeds and confirm the Product Label & Badges embed is toggled on and saved. (2) In the app dashboard, confirm at least one badge has status Active and its targeting rules match at least one product in your store.
The badge appears in the wrong position or is clipped
This usually means your theme applies overflow: hidden to product image containers. Try switching to a corner position preset first. If that doesn't help, use the custom XY offset (Pro) to nudge the badge inside the visible area. You can also contact support and we'll provide theme-specific CSS.
My badge targeting a collection isn't showing on all products
Collection-based targeting reflects Shopify's published collection membership. If a product was recently added to a collection, wait a few minutes for Shopify's cache to propagate. Also ensure the product itself is Active (not Draft) in your Shopify admin.
The inventory/discount rule badge isn't updating in real time
Dynamic rule conditions are evaluated on each page load by the storefront script. If you see stale results, do a hard refresh (Ctrl+Shift+R / Cmd+Shift+R) to bypass browser cache. If the problem persists on the live store with no cache, contact support with the product URL and badge name.
My Pro badge limit shows "0 active" after downgrading
When downgrading from Pro to Free, badges above the 5-badge free limit are automatically paused (not deleted). Go to the Badges list, and you'll see paused badges marked accordingly. Re-upgrade to Pro or deactivate lower-priority badges to bring others back within the limit.
Analytics data shows 0 clicks even though the badge is visible
Click tracking only fires for badges that have a Click URL set. Open the badge in the editor, go to the Behaviour section, and enter a destination URL. Impressions are always tracked regardless of whether a click URL is set.
Still stuck?

Our support team responds within 1 business day and knows Shopify inside-out.

Contact Support