> For the complete documentation index, see [llms.txt](https://docs.shopperos.stackline.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shopperos.stackline.com/catalog/product-details.md).

# Product details

A product page lets you check one product's data, edit its content, and set how shoppers can buy it. Each product in your catalog has its own product page.

To open it, go to **Catalog** and click a product title. To go back to the list, click **Catalog** in the breadcrumb at the top.

<figure><img src="https://489913050-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FblcXcPwOUg5osGsERflQ%2Fuploads%2Fgit-blob-276c7b45e1d741b7abaf79f9dac950c9808669c9%2Fproduct-overview.jpg?alt=media" alt="A product page, Overview → Summary"><figcaption><p>A product page on Overview → Summary. The left panel holds the product card, the availability control and the section menu.</p></figcaption></figure>

## Three parts on the left

The left panel stays the same in every section of the product page.

* **The product card**: the image, the brand, and the title. Point to the card and click **+** to see the **Stackline SKU**, **Category**, and **Subcategory**. Click **−** to turn the card back.
* **The availability control**: <mark style="color:green;">Available</mark> or Unavailable.
* **The section menu**: the nine sections of the product page.

### Make a product available or unavailable

An unavailable product is hidden from shoppers. You can make it available again at any time.

{% stepper %}
{% step %}

### Open the control

Click the availability control under the product card.
{% endstep %}

{% step %}

### Choose the change

Click **Make Unavailable** or **Make Available**. A dialog opens.
{% endstep %}

{% step %}

### Confirm

Read the dialog. Click **Make Unavailable** or **Make Available** to confirm.
{% endstep %}
{% endstepper %}

| Setting         | What shoppers see                                                                     |
| --------------- | ------------------------------------------------------------------------------------- |
| **Available**   | Shoppers can find and buy the product.                                                |
| **Unavailable** | Shoppers cannot find or buy the product. You can make it available again at any time. |

Done. The control shows the new state. This setting also shows as **Shopper OS Ready** in **Overview → Details**.

## Nine sections, one product

Each section of the menu covers one part of the product's life, from content to fulfillment.

Most sections that show numbers have a date control at the top. Choose **52W**, **26W**, **13W**, **4W**, **YTD**, or **Custom**.

| Section                                                | Tabs                                                                                                                         | What you can do                                                                  |
| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| [**Overview**](#overview-sales-matches-and-variations) | **Summary**, **Matches**, **Variations**, **Details**                                                                        | See sales. Add or remove retailer matches. Edit variation types.                 |
| [**Assets**](#assets)                                  | **Content**, **Images**, **Videos**, **Testimonials**, **Claims**, **Questions**, **Stats**, **Benchmarks**, **Meta Fields** | Edit the content that shoppers see on the product page and in the concierge.     |
| [**Pages**](#pages)                                    | **Summary**, **Knowledge**                                                                                                   | See page traffic. Add knowledge for pages.                                       |
| [**Reviews**](#reviews)                                | **Summary**, **Platform**, **Integrated**, **Marketplace**                                                                   | Read only. See ratings and reviews.                                              |
| [**Rewards**](#rewards)                                | **Summary**                                                                                                                  | Read only. See reward activity and campaigns.                                    |
| [**Checkout**](#checkout)                              | **Where-to-Buy**, **Store Locator**, **Checkout**, **Prices**, **Subscribe & Save**                                          | Set how shoppers buy this product.                                               |
| [**Fulfillment**](#fulfillment)                        | One page                                                                                                                     | Read only. See the linked inventory and fulfillment orders.                      |
| [**Concierge**](#concierge)                            | **Summary**, **Knowledge**, **Marketing Rules**                                                                              | See concierge activity. Add knowledge and marketing rules.                       |
| [**Research**](#research)                              | **Product facts**, **Journeys**, **Competitors**, **Audience**                                                               | Run one Catalyst research step for this product, and see what it read and found. |

## Overview: sales, matches and variations

Overview shows the product's sales, its matches at other retailers, and its variations.

| Tab            | What it shows                                                                                                                                                                                                                                                             |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Summary**    | **Sales Summary**: **Retail Sales**, **Units Sold**, **Orders**, and **AVG Sell Price**. Click a metric to chart it. The **Orders** table lists each order. Click **Filter** to filter by **Order Format**: **Sync Orders**, **Checkout Orders**, or **External Orders**. |
| **Matches**    | **Matched Products**: the same product at other retailers.                                                                                                                                                                                                                |
| **Variations** | **Variation Summary** and **Associated Child Variations**: the parent SKU and the other variations of this product.                                                                                                                                                       |
| **Details**    | **Product Meta Data** in four cards: **Retailer**, **Taxonomy**, **Status**, and **Shopping**. Read only.                                                                                                                                                                 |

### Matches: the same product at other retailers

A match links this product to the same product at another retailer. Matches are on **Overview → Matches**.

Each match card shows the matched product's own image, its brand and its title. It also shows **Stackline SKU**, **Retailer SKU**, **Retailer Price** and **Retailer**. **Retailer** shows the retailer name with its retailer ID in brackets, as **Name (retailer ID)**. When the name is not known, it shows the ID only.

{% stepper %}
{% step %}

### Open the dialog

On **Overview → Matches**, click **Add Match**. The **Add Match** dialog opens.
{% endstep %}

{% step %}

### Choose a channel

Select a channel. A channel of a known retailer shows as **Name (retailer ID)**.
{% endstep %}

{% step %}

### Search for the product

Search by title, Stackline SKU, or retailer SKU. Each result shows the product's own image and title, **Retailer**, **Retail Price** and **Retailer SKU**. The **Retailer** column uses the **Name (retailer ID)** form too.
{% endstep %}

{% step %}

### Add the match

Select the product, and click **Add Match**. The new card shows under **Matched Products**.
{% endstep %}
{% endstepper %}

To open the matched product, click the <mark style="color:green;">Matched</mark> control on its card, then **View product details**.

To remove a match:

1. Click the <mark style="color:green;">Matched</mark> control on its card.
2. Click **Unmatch product**.
3. Confirm in the dialog.

### Edit variations

* To change a variation type, edit it in the **Types** card, and click **Save**. This works only when the product has a parent SKU.
* To remove a child from this parent, open its row menu in **Associated Child Variations**. Click **Unlink from this parent SKU**, and confirm in the dialog.

## Assets

Assets are the content that shoppers see. Only approved items show to shoppers.

Most asset tabs have a **Status** for each item: <mark style="color:green;">Approved</mark>, <mark style="color:orange;">Pending</mark>, or <mark style="color:red;">Denied</mark>. To change a status, click it and choose the new one. Then click **Change status**.

| Tab              | What it holds                                                                                                                                                                                                                        | Actions                                                                        |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
| **Content**      | The master title and bullets (**Title**, **Bullet 1** to **Bullet 5**), and other content sources.                                                                                                                                   | **Add Content**, edit a field, **Set as master**, **Lock content**, **Export** |
| **Images**       | **Master Carousel Images** (up to 10) and **Additional Image Assets**.                                                                                                                                                               | **Add Images**, move images to and from the carousel, download, delete         |
| **Videos**       | **Main Video**, **Video Carousel**, and **Additional Video Assets**.                                                                                                                                                                 | **Add Videos**, **Set as main video**, remove, delete                          |
| **Testimonials** | Customer quotes for this product.                                                                                                                                                                                                    | **Add Testimonials**, **Generate with AI**                                     |
| **Claims**       | Product claims.                                                                                                                                                                                                                      | **Add Claims**                                                                 |
| **Questions**    | **Concierge Questions**: starter questions that show as chips in the concierge.                                                                                                                                                      | **Add Question**, **Generate with AI**, delete                                 |
| **Stats**        | **Units Sold Stats**, **Positive Rating Share Stats**, and **Keep Rate Stats**.                                                                                                                                                      | **Add new stat**, set **Display** to **Show** or **Hide**                      |
| **Benchmarks**   | **Brand Survey Benchmarks**.                                                                                                                                                                                                         | Set **Display** to **Show** or **Hide**                                        |
| **Meta Fields**  | Lists that show as sections on the product page. A brand with product fields sees its own fields and the product's group. Other brands see **What's Included**, **Technical Specs and Details**, **Ingredients**, and **Packaging**. | **Add Meta Field**, edit, **Generate with AI**                                 |

### Content and the master version

The **Master Content** card shows the content that is published. The second card shows another source, such as a retailer or content that you added. Pick the source from its menu.

* Click **Set as master** on the source card to replace all master content with that source.
* Click the **Set as master** icon on one field to replace only that field.
* Click the **Edit** icon on a field to edit it. Then click **Save**.

Click **Lock content** to lock the master content. While it is locked, you cannot edit fields or pick another source. Click **Unlock content** to unlock it. A lock changes the live page for this product only.

On a family master product, a lock guides AI generation but does not change the live page. To change what shoppers see, lock a variant.

### Questions and generated content

Generated questions go live until 5 are active. More generated questions arrive as <mark style="color:orange;">Pending</mark> for you to review.

For meta fields, generated drafts come from this product's own catalog data. Ingredients have no catalog source.

{% hint style="warning" %}
Always check a generated **Ingredients** list against the product label.
{% endhint %}

A value that the AI filled shows the source **AI extracted**. If you edit it, ShopperOS keeps your text, and the value counts as entered by hand. Later AI runs do not change it.

To approve or deny the values of many products at once, use **Review** in **Settings → Catalog → Product fields**. See [Review values](/catalog/catalog.md#review-values).

### Check values against your store page

**Crawl store PDP** reads this product's page on your own store, with its images. Then it compares what it finds with the saved values. A brand with product fields sees it on **Assets** → **Meta Fields**, beside **Generate with AI**.

{% stepper %}
{% step %}

### Start the crawl

Click **Crawl store PDP**. The crawl takes about a minute.
{% endstep %}

{% step %}

### Read the review

The review sorts what the crawl found into sections.

| Section              | What it shows                                                                       |
| -------------------- | ----------------------------------------------------------------------------------- |
| **Different**        | The page says something else. The saved value and the page value show side by side. |
| **New**              | No value is saved yet. These start ticked.                                          |
| **Matching**         | The page agrees with the saved value.                                               |
| **Not on page**      | A value is saved, but the page does not show it. Nothing is deleted.                |
| **Size gaps**        | Variants that got no value, and answers that matched no variant.                    |
| **Suggested fields** | Facts on the page that fit no field. They are not saved.                            |
| {% endstep %}        |                                                                                     |

{% step %}

### Tick the values to keep

A **Different** value replaces the saved one only when you tick it.
{% endstep %}

{% step %}

### Save

Click **Apply selected** to save them as approved. Or click **Save for later** to save them for review.
{% endstep %}
{% endstepper %}

Done. The values you ticked are saved. Values saved for later wait under **Review** in [Settings → Catalog → Product fields](/catalog/catalog.md#review-values).

<mark style="color:purple;">Brandclub team</mark> The team also sees **Add as field** and **Belongs to a field** beside each suggested fact. **Add as field** drafts a new product field from the fact. The team checks it, tries it on the product, and saves it to Base or to a group. **Belongs to a field** improves the hint of a field that missed the fact. After either, the crawl runs again for that field, so you can apply its value. Other products get a new field at the next **Fill product fields**.

## Pages

Pages shows the traffic of the pages that show this product, and the knowledge your AI agent uses for them.

| Tab           | What it shows                                                                                                                                                                  |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Summary**   | **Pages Summary**: **Page Count**, **Pageviews**, **Unique Users**, and **Retail Sales** from pages that show this product. **Product Pages** lists each page.                 |
| **Knowledge** | **Product Page Knowledge**: facts that change how your AI agent describes this product in pages. Click **Add knowledge** to add one. Use the row menu to **View** or **Edit**. |

To build and publish pages, see [Pages and themes](/pages-studio/pages.md).

## Reviews

Reviews shows ratings and reviews from every source. All four tabs are read only.

| Tab             | What it shows                                                                                                       |
| --------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Summary**     | **Review Metrics** from all sources, **Review Sources**, and **Product Reviews**.                                   |
| **Platform**    | Reviews from the Shopper OS platform, with spend metrics such as **Total Spend**, **Cost per Rating**, and **ROI**. |
| **Integrated**  | Reviews from your integrated sources.                                                                               |
| **Marketplace** | Reviews from marketplace sources.                                                                                   |

## Rewards

Rewards shows the reward activity of this product. This section is read only.

* **Summary** shows **Reward Metrics**, such as **Net Rewards**, **Pending Rewards**, and **Retail Sales**.
* **Reward Campaigns** shows the spend and live campaigns of each campaign type.
* **Product Rewards** lists each reward.

To create campaigns, see [Rewards and campaigns](/growth/growth.md).

## Checkout

The **Checkout** section sets how shoppers buy this product.

* **Where-to-Buy** and **Store Locator**: see [Where to buy and store locator](/catalog/where-to-buy.md#product-settings).
* **Checkout** and **Prices**: see [Product-level checkout](/selling-and-checkout/checkout-and-payments.md#product-level-checkout).
* **Subscribe & Save**: see [Subscribe & Save](/selling-and-checkout/subscribe-and-save.md). This tab shows only after you turn on Subscribe & Save for your project.

## Fulfillment

Fulfillment shows where this product ships from and the orders that contain it.

* **Linked inventory** shows the inventory item that this product ships from: **Seller SKU**, **FNSKU**, **MCF Account**, **Available**, **Reserved**, and **Linked Channels**.
* **Fulfillment orders** lists the orders that contain this product. Expand a row to see the shipment and the tracking details.

{% hint style="warning" %}
**Linked inventory** can read **This product has no inventory link, so a cart containing it fails at checkout.** Then link the product's listing to an Amazon seller SKU. See [Listings and inventory](/fulfillment/listings-and-inventory.md).
{% endhint %}

## Concierge

Concierge shows how your concierge talks about this product, and lets you guide it.

| Tab                 | What it shows                                                                                                                                                    |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Summary**         | **Key Metrics**, such as **Conversations**, **Product Impressions**, **Product Clicks**, and **Orders**. **Data Table by Conversation** lists each conversation. |
| **Knowledge**       | **Product Concierge Knowledge**: facts that change how your concierge describes this product. Click **Add knowledge** to add one.                                |
| **Marketing Rules** | **Product Marketing Rules**: rules that change how your concierge promotes this product. Click **Add rule** to add one.                                          |

For knowledge that applies to your whole store, see [Knowledge and guardrails](/concierge/knowledge.md).

## Research

The **Research** section runs one Catalyst research step for this product, outside a page. Use it to check what Catalyst reads and finds before you build a page. Each tab is one step: **Product facts**, **Journeys**, **Competitors**, or **Audience**. For what each step reads, see [What the research reads](/pages-studio/catalyst.md#what-the-research-reads).

A run does not change any page or chat.

```mermaid
flowchart LR
  F[Product facts] --> J[Journeys]
  F --> C[Competitors]
  J --> C
  F --> A[Audience]
  J --> A
  C --> A
```

*Some steps build on earlier steps. Journeys builds on Product facts. Competitors builds on Product facts and Journeys. Audience builds on all three.*

### Run a step

Before you start, run the earlier steps. If an earlier step has not run for this product, a warning names it. Run it first, so the findings can use it.

{% stepper %}
{% step %}

### Open the step

In **Research**, open the step's tab.
{% endstep %}

{% step %}

### Run it

Click **Run this step**. The button shows **Running…**. A run takes a minute or two.
{% endstep %}
{% endstepper %}

Done. When it ends, the run shows its results. Next, [read the run](#read-a-run).

Each step keeps one run for each product.

* To run the step again, click **Run again**. A new run replaces the last one, and reads the data again.
* To delete a run, click **Delete run**, then **Delete** to confirm.

### Read a run

Choose a view in **Show**:

| View         | What it shows                                                                                                                                                                                |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Data**     | What the step read. See the tables below.                                                                                                                                                    |
| **Findings** | The findings, in the same cards as a Catalyst page. You cannot change them here.                                                                                                             |
| **Checks**   | Each check of the run, with <mark style="color:green;">Pass</mark> or <mark style="color:red;">Fail</mark>, what it found, and what it means. The view name counts the failing checks.       |
| **Skills**   | The instructions this step runs with. Edit a file and click **Save for this app** to change it for your project only. Reset it to go back to the global file. The next run uses your change. |

Click **Download data** to save the whole run as a file.

The **Data** view holds these tables. Click a row to open its detail.

| Table                        | What it shows                                                                                                                                                                                                                                                                                                    |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Listings research reads**  | Every retailer listing of the product, with **Retailer**, **Found by**, **Price**, **Rating**, and **Reviews**. **Found by** is **Catalog offer**, **Linked listing**, **Product match**, or **AI match**. Open a row to see its retailer SKU, units and sales over four weeks, the Atlas week, and its bullets. |
| **Sources read**             | Each source the step asked, with how much it found and its state: **Read**, **No data**, or **Failed**. Open a source to see how it read, and what it read.                                                                                                                                                      |
| **Retailers**                | One listing for each retailer, with its latest Atlas numbers. **Product facts** only.                                                                                                                                                                                                                            |
| **Copy each retailer shows** | The title and bullets each retailer shows today. **Product facts** only.                                                                                                                                                                                                                                         |
| **Image facts**              | What the catalog and retailer images show, and the words on them. **Product facts** only.                                                                                                                                                                                                                        |
| **Review themes**            | The themes of the reviews, with what shoppers say. **Product facts** only.                                                                                                                                                                                                                                       |
| **Journey targets**          | The keywords and AI questions, with their fit, volume, and traffic. **Journeys** only.                                                                                                                                                                                                                           |
| **Competitors**              | Each competitor, with **Found by**, **Likeness** to your product, **Price**, **Rating**, and **Reviews**. Open a row to see its search clicks, keyword overlap, bullets, top keywords, and AI questions. **Competitors** only.                                                                                   |
| **Audiences**                | Your brand's AI audiences for the product's subcategory. **Audience** only.                                                                                                                                                                                                                                      |

A table with nothing in it shows **Nothing read**.

## What if…?

<details>

<summary>What if a research run failed?</summary>

A failed run shows **The run failed**, with the reason. Click **Run again**.

</details>

<details>

<summary>What if a run stops before it ends?</summary>

A run also fails when it stops before it ends, for example when the server restarts. It then reads as failed after about two minutes. Run the step again.

</details>

<details>

<summary>What if the carousel is full?</summary>

The carousel holds up to 10 images. Remove an image from the carousel first. More images go to **Additional Image Assets**.

</details>

## Troubleshooting

| Message                                    | What to do                                                                                           |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| **Oops! We've encountered an error**       | Reload the page. If the error stays, contact your Stackline team.                                    |
| **No product matches found**               | Click **Add a new match →** to match the product at a retailer.                                      |
| **No variations available**                | The product has no variation data. There is nothing to edit.                                         |
| **Maximum of 10 carousel images reached.** | Remove an image from the carousel first. More images go to **Additional Image Assets**.              |
| **This product cannot be fulfilled yet.**  | Link the product to inventory. See [Listings and inventory](/fulfillment/listings-and-inventory.md). |
| **The step did not start.**                | On **Research**, click **Run this step** again.                                                      |
| **The run failed: …**                      | Read the reason, then click **Run again**.                                                           |

## Next step

{% content-ref url="/pages/XObRYUzVta48F3iQ4KRe" %}
[Where to buy and store locator](/catalog/where-to-buy.md)
{% endcontent-ref %}
