How it works

This page explains how Sami Product Labels delivers badges, labels, trust badges, highlights, and banners to your storefront — no coding knowledge required.

App Embed block

When you install the app, it adds an App Embed block to your Shopify theme – a standard Shopify mechanism for running app functionality on your storefront.

Toggle the App Embed on or off anytime from your Shopify theme editor under App embeds. Off means no badges show; on means the app handles everything automatically.

Note

The app does not edit, overwrite, or inject code into your theme files. Everything runs through the App Embed block, which Shopify manages separately from your theme.

How configurations are delivered

Every badge, label, trust badge, highlight, and banner you create is saved as a Shopify metafield attached to your store – Shopify’s built-in system for storing custom data.

This means:

• No external API calls at page load — configurations are already stored in Shopify, so there’s no third-party server to wait on.
• Fast performance — badges load as fast as any other part of your theme.
• Reliability — badges stay available as long as your store is online, with no external server to go down.

How badges appear on your storefront

When a customer visits your store:

1. The App Embed script loads as part of your theme.
2. The script reads your badge configurations from the stored metafields.
3. It evaluates your targeting rules — which products, collections, pages, or customer segments should see each badge.
4. The matching badges are rendered on the page in the positions you configured.

This entire process happens in the customer’s browser and takes only milliseconds.

Analytics tracking

Sami Product Labels tracks two key events to measure badge performance:

• Add to cart — records which badge was displayed when a customer adds a badged product to their cart.
• Order placed — records the conversion when a customer completes a purchase with a badged product.

These events power your Analytics dashboard, showing which badges drive engagement and sales.

Note

Analytics tracking is available on the DIAMOND plan. The app only tracks aggregate events — it does not store personal customer information.

Country detection

The app detects the visitor’s country, powering country-based targeting so you can show different badges by region.

For example, you could display a “Free Shipping” badge only to customers in the United States, or show a “Local Pickup Available” badge to customers in your home country.

What the app does NOT do

• Does not modify your theme files — no Liquid code is injected.
• Does not slow down your store — data is stored in Shopify metafields, not fetched from external servers.
• Does not collect personal customer data — it uses customer tags and order counts for targeting only, never names, emails, or payment info.

---

Next steps

• Permissions and data access — learn what data the app accesses and how it is handled.
• Enable the app in your theme — get started by turning on the App Embed block.