> For the complete documentation index, see [llms.txt](https://docs.samita.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.samita.io/badges-and-labels/display-device-page.md).

# Control display by device and page

Control which pages and devices your badge appears on, exclude theme elements, and decide which badge wins when several apply to the same product.

The **Display** tab of the badge editor decides *where* and *when* a badge shows, after the **Products** tab has decided *which products* it applies to.

The tab is a list of collapsible sections:

| Section                         | What it controls                                                   | Documented in                                                                    |
| ------------------------------- | ------------------------------------------------------------------ | -------------------------------------------------------------------------------- |
| **Customer conditions**         | Which shoppers see the badge (logged in, tags, specific customers) | [Target by customer](/badges-and-labels/target-by-customer.md)                   |
| **Page conditions**             | Which page types the badge appears on                              | This page                                                                        |
| **Language conditions**         | The storefront language the visitor is browsing in                 | [Target by country & language](/badges-and-labels/target-by-country-language.md) |
| **Country conditions**          | The visitor's country                                              | [Target by country & language](/badges-and-labels/target-by-country-language.md) |
| **Other conditions**            | Product image, device, and excluded theme elements                 | This page                                                                        |
| **Visibility Date & Countdown** | Start/end dates and countdown timers                               | [Schedule visibility](/badges-and-labels/schedule-visibility.md)                 |
| **Priority conditions**         | Which badge wins when several apply to one product                 | This page                                                                        |

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-23c0cd1c1d68302ea8e2fb8c70a164d01ad6b172%2Fimage_92.png?alt=media" alt="Display tab of the badge editor with all sections collapsed"><figcaption><p>The Display tab. Sections with a chevron expand; sections with a switch are turned on first.</p></figcaption></figure>

{% hint style="info" %}
Sections with a **chevron** (⌄) simply expand. Sections with a **switch** (Language, Country, Priority) must be turned on before their fields appear.
{% endhint %}

## Open the Display tab

{% stepper %}
{% step %}

## Open the app

In your Shopify admin, go to **Apps** → **Sami Product Labels**.
{% endstep %}

{% step %}

## Open Badges & Labels

In the app's left menu, click **Badges & Labels**. The list shows every badge with its Id, name, preview, type, priority, position, and status.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-cb42828ea770a1edd9a0730a97a267901e2d2947%2Fimage_93.png?alt=media" alt="Badges &#x26; Labels list with the edit pencil highlighted"><figcaption><p>The Badges &#x26; Labels list. Click the pencil icon in the Actions column to edit a badge.</p></figcaption></figure>
{% endstep %}

{% step %}

## Edit the badge

Click the **pencil** icon in the **Actions** column of the badge you want to configure. The editor opens with three tabs: **Design**, **Products**, **Display**.
{% endstep %}

{% step %}

## Go to Display

Click the **Display** tab.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
The **Save** and **Discard** buttons in the top-right corner only appear once you change something. If you want to abandon your edits, click **Discard** → **Discard changes**.
{% endhint %}

## Page conditions

By default a badge shows on every page where the product appears. Add a page condition to limit it to certain page types.

### How to add a page condition

{% stepper %}
{% step %}

## Expand Page conditions

Click the **Page conditions** row to expand it. An **+ Add conditions** button appears.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-65a7fa300c96cb73d37cfcc15ca5c7ae3c486ec7%2Fimage_94.png?alt=media" alt="Page conditions section expanded showing the Add conditions button"><figcaption><p>An empty Page conditions section — no rule yet, so the badge shows everywhere.</p></figcaption></figure>
{% endstep %}

{% step %}

## Click + Add conditions

A condition row appears with three fields: **Page** (fixed), an operator, and a page type. The defaults are `Page` `is equal to` `Index page`.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-c7f7e496e14ab55e6be9e04ca6e1a7ff98096945%2Fimage_95.png?alt=media" alt="A page condition row with Page, is equal to, and Index page"><figcaption><p>Each click on <strong>+ Add conditions</strong> adds one row. Use the trash icon at the end of a row to remove it.</p></figcaption></figure>
{% endstep %}

{% step %}

## Choose the operator

* **is equal to** — show the badge only on the selected page type.
* **is not equal to** — show the badge everywhere *except* the selected page type.
  {% endstep %}

{% step %}

## Choose the page type

| Option                                | Where the badge appears                      |
| ------------------------------------- | -------------------------------------------- |
| **Index page**                        | Your storefront home page                    |
| **Collection page**                   | Collection / category listing pages          |
| **Product page**                      | Individual product pages                     |
| **Article Page**                      | Blog article pages                           |
| **Blog page**                         | Blog listing pages                           |
| **Cart page (including cart drawer)** | The cart page and the slide-out cart drawer  |
| **Search page**                       | Search results pages                         |
| **Specific pages**                    | Only the exact URL you enter (see next step) |

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-55952acd4431fee26acbed2dd9e2a197d1425b7c%2Fimage_96.png?alt=media" alt="Page type dropdown listing all eight options"><figcaption><p>The eight page types available for a page condition.</p></figcaption></figure>
{% endstep %}

{% step %}

## For Specific pages, enter the URL

Choosing **Specific pages** adds a fourth field. Enter the full storefront URL of the page, for example `https://your-store.myshopify.com/pages/summer-sale`. The placeholder shows your own store's URL as a guide.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-8a3be2495f630a18536792c7e93516c53779224d%2Fimage_97.png?alt=media" alt="Specific pages selected with the URL field beside it"><figcaption><p><strong>Specific pages</strong> adds a URL field — paste the full page URL, not just the path.</p></figcaption></figure>
{% endstep %}

{% step %}

## Save

Click **Save** in the top-right corner.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
A badge still needs to match the **Products** tab as well. A page condition narrows *where* a matching product shows its badge — it never makes the badge appear on products it does not apply to.
{% endhint %}

## Other conditions

Expand **Other conditions** to control which product image carries the badge, which devices see it, and which theme elements to skip.

| Setting                    | Options                                 | Behavior                                                                                                                                                         |
| -------------------------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Show on (product page)** | All images / First image                | Show the badge on every gallery image, or only on the first (main) product image.                                                                                |
| **Device targeting**       | All devices / Desktop / Mobile          | Limit the badge to desktop or mobile shoppers, or show it on all devices.                                                                                        |
| **Do not show label on**   | CSS class list — `.CLASS1, .CLASS2,...` | The badge is not rendered on any element matching these classes. Useful when a slider, quick-view, or upsell section in your theme doesn't suit badge placement. |

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-9477d557ce1d08ff1ab3a07a6e95f38df718ef72%2Fimage_98.png?alt=media" alt="Other conditions section with Show on, Device targeting, and Do not show label on fields"><figcaption><p>Image, device, and exclusion settings all live under Other conditions.</p></figcaption></figure>

{% hint style="info" %}
**Do not show label on** expects CSS **class** selectors separated by commas, each starting with a dot — for example `.product-card__slider, .quick-view`. Inspect the element in your theme to find the class name.
{% endhint %}

## Priority conditions

When several badges match the same product, priority decides which one is displayed.

{% stepper %}
{% step %}

## Turn on Priority conditions

Click the switch on the **Priority conditions** row. A **Priority value** field appears.
{% endstep %}

{% step %}

## Enter a priority value

Type a number from **0 to 100**. **0 is the highest priority, 100 is the lowest.** The app shows the same tip under the field.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-3265d7b9e1da680dd467c85fbd435d004c095269%2Fimage_99.png?alt=media" alt="Priority conditions turned on with the Priority value field and tip"><figcaption><p>Lower number = higher priority. A badge is hidden if the product already has a higher-priority badge.</p></figcaption></figure>
{% endstep %}

{% step %}

## Save

Click **Save**. The value now shows in the **Priority** column of the Badges & Labels list, so you can compare all your badges at a glance.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Badges with priority turned **off** show as `None` in the list and are not part of the comparison. If you want one badge to reliably win over another, set a priority value on **both**.
{% endhint %}

### Priority example

| Badge           | Priority value | Result on a product matching both |
| --------------- | -------------- | --------------------------------- |
| **Sale off**    | `0`            | Shown                             |
| **Best seller** | `10`           | Hidden                            |

## Next steps

* [Change badge position](/badges-and-labels/change-position.md) — Adjust where the badge sits on the product image.
* [Target products](/badges-and-labels/target-products.md) — Choose which products display your badge.
* [Schedule visibility](/badges-and-labels/schedule-visibility.md) — Set start and end dates for a badge.

{% hint style="success" %}
**Need support?**

If you run into any difficulty while following these steps, contact us at <support@samita.io>.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.samita.io/badges-and-labels/display-device-page.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.