> ## Documentation Index
> Fetch the complete documentation index at: https://help.vori.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Understanding the Promotions Dashboard & Hierarchy

> Learn how to navigate your promotions, understand the relationship between offers and products, and identify active deals at a glance.

✏️ **Note:** This article describes features and is launching with select stores (in beta testing). For instructions on accessing New Back Office, view our guide: [Access New Back Office.](/vori-setup-and-troubleshooting/access-the-new-vori-back-office)

### Understanding the Promotion Hierarchy

The Vori Promotions tool can be found under Products in the left-hand navigation.

<iframe src="https://www.loom.com/embed/d1744574c60c4b8fba7655a5bf26d1dd" frameBorder="0" allowFullScreen style={{width: "100%", height: "400px"}} />

New Promotions are organized in a specific three-tier structure to keep your data organized. Understanding this hierarchy helps you identify exactly how a deal is set up.

1. **Promotion (The Container):** This acts as the "folder" for your sale. It holds the name (e.g., "Super Bowl Weekend") and the dates/times the sale is active.

   <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-20-at-11.31.42-am.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=f3a9e2920679f4297567c9cc829f2359" alt="Screenshot 2026-01-20 at 11.31.42 AM" width="1077" height="98" data-path="images/screenshot-2026-01-20-at-11.31.42-am.png" />
2. **Offer (The Logic):** This lives inside the Promotion. It defines the math (e.g., "Buy 1 Get 1 Free" or "20% Off").

   <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-20-at-11.32.09-am.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=e300fe6826aa28fbaf1acf02725be0fa" alt="Screenshot 2026-01-20 at 11.32.09 AM" width="1098" height="175" data-path="images/screenshot-2026-01-20-at-11.32.09-am.png" />
3. **Product:** These are the specific SKUs attached to the Offer.

   <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-20-at-11.31.10-am.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=0d76fa97af44ef86cf835232d11ea4fa" alt="Screenshot 2026-01-20 at 11.31.10 AM" width="1480" height="447" data-path="images/screenshot-2026-01-20-at-11.31.10-am.png" />

#### Manual vs. Dynamic Selection

When viewing products within an offer, Vori indicates how those items were added:

* **Wand Icon:** Indicates **Dynamic Selection**. This means this product is part of a group or range based on specific conditions. These selections are "dynamic" because the list of included items will automatically update if your Product Catalog changes (e.g., adding a new product that matches the "Chips" condition).\\
  <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-20-at-8.13.19-pm.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=4a302ff34b3a896878e23a31a0a30ef5" alt="Screenshot 2026-01-20 at 8.13.19 PM" width="1061" height="439" data-path="images/screenshot-2026-01-20-at-8.13.19-pm.png" />
* **No Icon:** Indicates **Manual Selection**. These products were added directly and individually to the offer.

  <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-20-at-8.19.28-pm.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=1653ce00dfd89ab3ac4a3378c92ea241" alt="Screenshot 2026-01-20 at 8.19.28 PM" width="792" height="370" data-path="images/screenshot-2026-01-20-at-8.19.28-pm.png" />

***

### View Promotion Status

The **Status** column tells you which deals are currently live at your store.

* **Draft:** The promotion is incomplete and has not been published.
* **Pending:** The promotion has a future start date and is not yet active.
* **Active:** The promotion is currently live and will ring up at the POS.
* **Completed:** The promotion date has passed.
* **Canceled:** The promotion has been manually stopped. To preserve reporting integrity, any promotion that was ever **Active** can only be **Canceled, never Deleted.**
* **Deleted:** This status is reserved exclusively for **Drafts** that were never published. Once a draft is deleted, it is permanently removed from the system.

You can sort your dashboard by clicking the **Status** column header to group all **Active** deals together.

<img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-25-at-2.09.33-pm.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=1f27b58c59a30dae1350d42ea170545f" alt="Screenshot 2026-01-25 at 2.09.33 PM" width="2338" height="1244" data-path="images/screenshot-2026-01-25-at-2.09.33-pm.png" />

***

### Search & Filter: Finding Active Deals

You can quickly check if a specific item is already on sale or find a campaign by name using the search and filter tools.

#### Quick Search

Use the search bar at the top of the Promotions table to find deals by:

* \*\*Product Name

  <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-25-at-2.15.52-pm.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=6024c769505a3de4445851b165f57b30" alt="Screenshot 2026-01-25 at 2.15.52 PM" width="2410" height="962" data-path="images/screenshot-2026-01-25-at-2.15.52-pm.png" />\*\*
* \*\*Barcode (UPC/PLU)

  <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-25-at-2.16.53-pm.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=66f3a9a4bb40ba39492818e953a0cf39" alt="Screenshot 2026-01-25 at 2.16.53 PM" width="2422" height="1012" data-path="images/screenshot-2026-01-25-at-2.16.53-pm.png" />\*\*
* **Promotion Name\
  <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-25-at-2.18.40-pm.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=1cf83380217174f953e7e9e1de543e3b" alt="Screenshot 2026-01-25 at 2.18.40 PM" width="2540" height="802" data-path="images/screenshot-2026-01-25-at-2.18.40-pm.png" />**

#### Advanced Filtering

For more complex searches, use the **Filter** tool:

1. Click **Filter** at the top left of the Promotions table.
2. Select a category (such as **Barcode**) from the dropdown menu.\\
   <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-25-at-2.21.24-pm.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=41940ed0d164e99d22e0343cacd4109b" alt="Screenshot 2026-01-25 at 2.21.24 PM" width="1190" height="1124" data-path="images/screenshot-2026-01-25-at-2.21.24-pm.png" />
3. Enter the specific value you want to check.

   <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-25-at-2.22.58-pm.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=9a6dd6b78d9ae51fe7bf7c698d4812bf" alt="Screenshot 2026-01-25 at 2.22.58 PM" width="2220" height="834" data-path="images/screenshot-2026-01-25-at-2.22.58-pm.png" />
4. The table will update to show only the Promotions matching those criteria.

**💡Tip:** You can save frequent searches (like "Active Dairy Promos") by clicking **Save View** in the top right corner.

<img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-20-at-11.40.26-am.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=7414946ccac03905d8f32aae166b275c" alt="Screenshot 2026-01-20 at 11.40.26 AM" width="392" height="215" data-path="images/screenshot-2026-01-20-at-11.40.26-am.png" />

***

### Identifying Promotional Pricing

Vori uses visual cues next to each product to help you identify deals without opening every item.

#### The Purple Promotion Icon

A purple tag icon next to a price indicates the product is on promotion.  Hover over this icon to see a quick summary of the deal.

<img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-20-at-3.47.53-pm.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=689acdcab5845995882a4db3b1b02919" alt="Screenshot 2026-01-20 at 3.47.53 PM" width="181" height="56" data-path="images/screenshot-2026-01-20-at-3.47.53-pm.png" />

#### Pricing Display Types

* **Strikethrough Price:** Indicates a **TPR (Temporary Price Reduction)**. You will see the original price crossed out with the new promotional price next to it.

  <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-20-at-3.51.09-pm.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=d9e1608ace8a09408d5cee26173c65ba" alt="Screenshot 2026-01-20 at 3.51.09 PM" width="639" height="247" data-path="images/screenshot-2026-01-20-at-3.51.09-pm.png" />
* **Purple Icon Only:** Used when the final price is conditional (e.g., "Buy 2 Get 1 Free"). Because the price depends on what the shopper buys, a single "new" price isn't displayed.

  <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-20-at-3.47.04-pm.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=2e2147acde3d1cfb00cc34f89328cc76" alt="Screenshot 2026-01-20 at 3.47.04 PM" width="483" height="197" data-path="images/screenshot-2026-01-20-at-3.47.04-pm.png" />
* **Bold Purple Text:** Indicates the product has **multiple active promotions** overlapping. Bold Purple Text is **currently only visible in the Product Catalog table**. The Promotions Table does not yet feature this bolding for multiple deals.

  <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-01-20-at-8.27.33-pm.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=a65468638e15375efd07417a6d62795d" alt="Screenshot 2026-01-20 at 8.27.33 PM" width="1340" height="630" data-path="images/screenshot-2026-01-20-at-8.27.33-pm.png" />

#### Managing Promotion Overlaps

You can view the priority of these offers on the **Product Details** page under **Pricing → Active Promotions**. Vori uses the following priority rules:

* **Priority 1:** The promotion ending soonest takes precedence.
* **Priority 2:** If two promotions end at the same time, the most recently created one takes priority.

  <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-02-23-at-4.28.58-pm.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=36355a4620f7012b846d37aa571f583f" alt="Screenshot 2026-02-23 at 4.28.58 PM" width="1458" height="614" data-path="images/screenshot-2026-02-23-at-4.28.58-pm.png" />

**💡Strategic Overlaps:** You can use these rules to "stack" different types of deals. For example, if you want to offer a discounted price for a single item but a BOGO deal for customers who buy two, set the BOGO to end slightly earlier (even by one hour) than the single-item discount. This ensures the system selects the BOGO as the primary offer when the quantity requirements are met.

**Example**:

* **Step 1: Create the \$1.99 Promotion**

  * Set this as a standard price reduction.
  * Set the **End Date** or **Time**  to be further out (for example, March 2nd).

    <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-02-23-at-4.26.48-pm.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=86e8e18ca86b8a598b7bb79cc478eb86" alt="Screenshot 2026-02-23 at 4.26.48 PM" width="2842" height="352" data-path="images/screenshot-2026-02-23-at-4.26.48-pm.png" />
* **Step 2: Create the BOGO Promotion**

  * Set this as a "Buy 1, Get 1 Free" offer.
  * Set the **End Date** to be slightly earlier than the first one (for example, February 28th).

    <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/screenshot-2026-02-23-at-4.27.06-pm.png?fit=max&auto=format&n=TzaENelmTOYnXeX4&q=85&s=2962bbe8578094fd73c4d1d2b142ca01" alt="Screenshot 2026-02-23 at 4.27.06 PM" width="2868" height="428" data-path="images/screenshot-2026-02-23-at-4.27.06-pm.png" />
* \*\*Step 3: POS Experience

  <img src="https://mintcdn.com/vori/TzaENelmTOYnXeX4/images/ezgif-4df8d77dd55c4c83.gif?s=9cb730175725798d3d411d4e39361089" alt="ezgif-4df8d77dd55c4c83" width="800" height="502" data-path="images/ezgif-4df8d77dd55c4c83.gif" />\*\*

***

**➡️ Next Step:** Ready to start building? Learn **[How to Create a Promotion: Time, Frequency, & Schedule](/promotions/creating-a-promotion-time-frequency-schedule)** to set up your deal's "container."
