> 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/extra-features/target-highlight-display.md).

# Target highlight display

Control where a highlight block appears and who sees it, using the conditions on the Placement tab.

Every highlight block has its own display rules. You set them on the **Placement** tab of the highlight editor, which holds five condition groups plus the two placement options.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-bc81ce9b7cb8202f7d8aa24dacfb7e1090cd2990%2Fimage_153.png?alt=media" alt="Placement tab of the highlight editor with all condition sections"><figcaption><p>The Placement tab combines display conditions with the product page toggle and the shortcode.</p></figcaption></figure>

{% hint style="info" %}
Leave every condition group empty to show the highlight everywhere it is placed. Conditions only narrow it down.
{% endhint %}

## Product conditions

Decide which products the highlight appears on.

Set **Products must match** to **all conditions** (every rule must be true) or **any condition** (one rule is enough), then click **Add conditions** to build a rule row:

| Field         | Options                                                                          |
| ------------- | -------------------------------------------------------------------------------- |
| **Condition** | **Select Products**, **Product tag**, **Product compare price**, **Collections** |
| **Operator**  | **is equal to** / **is not equals to**                                           |
| **Value**     | Click **select items** to pick the products, tags, or collections                |

Use the trash icon at the end of a row to remove that rule.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-78cb2da37f482bd5a500fa870d146f547efa697d%2Fimage_154.png?alt=media" alt="Product conditions with the all conditions and any condition options"><figcaption><p>Choose whether products must match all conditions or any condition.</p></figcaption></figure>

## Customer conditions

Decide who sees the highlight. Click **Add conditions** — the row is pre-filled with **Customer** / **Is Logged In**.

| Condition        | Operators                                  |
| ---------------- | ------------------------------------------ |
| **Customer**     | **Is Logged In** / **Not Logged In**       |
| **Customer tag** | Pick the customer tags the rule applies to |

{% hint style="info" %}
Highlights support these two customer conditions only. Badges and labels have a larger set — order count, total spent, purchase history, and company name. See [Target by customer](/badges-and-labels/target-by-customer.md).
{% endhint %}

## Page conditions

Decide which page types show the highlight. Click **Add conditions**, then pick the page:

| Field        | Options                                                                                                            |
| ------------ | ------------------------------------------------------------------------------------------------------------------ |
| **Operator** | **is equal to** / **is not equals to**                                                                             |
| **Page**     | Index page, Collection page, Product page, Article Page, Blog page, Cart page (including cart drawer), Search page |

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-3d4fb54f75b6700b86e60947208927f9324c4db4%2Fimage_155.png?alt=media" alt="Page conditions with the page type dropdown open"><figcaption><p>Limit the highlight to specific page types, or exclude them.</p></figcaption></figure>

## Language conditions

Turn on the **Language conditions** toggle, set the **Operator**, then search for and select the languages the rule applies to.

## Country conditions

Turn on the **Country conditions** toggle, set the **Operator**, then search for and select the countries the rule applies to.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-b219da36e6804db449fb4bc487ec20e7bf392421%2Fimage_156.png?alt=media" alt="Language and country conditions with their operator and search fields"><figcaption><p>Language and country conditions are off by default — switch them on to use them.</p></figcaption></figure>

## Where the highlight is placed

Conditions decide *whether* the block shows; these two settings decide *where*:

| Option           | What it does                                                                                                                                                                               |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Product page** | Turn on to display the highlight at the app's built-in position on every product page.                                                                                                     |
| **Shortcode**    | Copy `<div class="samitaPL-highlight" data-id="…"></div>` and place it in your theme yourself — see [Place a highlight with shortcode](/extra-features/place-highlight-with-shortcode.md). |

{% hint style="warning" %}
Save the highlight before copying its shortcode — on an unsaved block the snippet reads `data-id="new"` and will not render.
{% endhint %}

## Next steps

* [Create a highlight](/extra-features/create-highlight.md) — build the block and style its grid.
* [Highlight overview](/extra-features/highlight-overview.md) — what highlights are and when to use them.
* [Pricing plans](/settings/pricing-plans.md) — what each plan includes.

{% 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/extra-features/target-highlight-display.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.