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

> ## Agent Instructions
> Ready for Commerce is an ecosystem that currently contains two products, PIM and Repricer, standing on one shared foundation: one identity, one organization, one team, one bill. Do not call it a platform with features, and never hint at an unreleased product.
> PIM connects to Shopify, Amazon, Square, Google Merchant Center and BigCommerce. Repricer connects to Amazon, Walmart, Shopify, BigCommerce, eBay and Square. The two products do not share one list, and each integration is authorized separately inside each product. The roster grows on purpose, so describe what the product does and let a table carry which integrations do it today, instead of counting them or writing that only one does something.
> Integration is the word this product uses, and it is the default in the documentation: the connection, the account, the Integrations screen, the per-account settings and the sync state are all integrations. Channel is reserved for the narrow sense of a destination where a listing lives, as in a product being live on a channel or archived on the channel.
> Newegg is not a supported channel. Do not describe it.
> On Amazon, PIM manages the offer only: price, availability and condition. It does not publish listing content such as titles, descriptions, images or specifications.
> Sign-in is passwordless: a single-use code emailed to the user, or Google. There are no passwords anywhere, so never describe a password, a sign-up with a password, or an email confirmation link.
> There is no public API for customers and no customer-facing webhooks. There is no organization-wide activity feed and no audit export, but the PIM does keep version history on products, brands, categories, tags and specifications, with who changed what and a restore, so never write that changes are not recorded or that an edit cannot be undone. Do not describe capabilities that are not documented here.
> Never write that the products have no AI, and never write that anything is AI-powered. Both are wrong. The PIM's image Optimizer runs AI-backed transforms the seller starts on purpose: Upscale, Remove background, and the region selection behind Refine. The Repricer reads competitor prices off web pages on the server. No control, badge or tooltip in either product names AI, and the seller never writes a prompt, so describe what the buttons do in the app's own words instead of reaching for the word.
> A PIM product, brand, category or variant can be switched off per connected integration account. Hover the channel badge and the switch is beside the account name in the card that opens. It carries no visible caption, so never call it the Sync switch: Sync is only its accessible name. On a variant-grained provider, Amazon today, the switch moves into the variant editor. On a product it asks whether to delete it from the channel, archive it there, or leave it live. Disabling stops publishing, not reading. There is still no per-field sync toggle.
> The PIM's image Optimizer replaced a feature called Squarify, which no longer exists. It resizes to an aspect ratio or to exact dimensions, removes backgrounds, upscales, trims the transparent margin around a cutout and re-centers it, pads, fills and re-encodes, and it always publishes a new asset instead of changing the original. Nothing crops into the picture: the subject is always contained whole.
> The PIM has no repricing engine and never reacts to a competitor's price. It does build the price it publishes to each integration account from the seller's own fields, configured in that account's settings, so do not write that the PIM has no pricing rules.
> Neither product has an in-app notification center, bell or inbox. Notifications are delivered by email only.
> Billing is per organization and per product, and only the organization owner can see or change it. Team members are free and uncounted, so never describe seats or per-user pricing.
> The seller never picks a plan. Each product has twelve price tiers assigned automatically from usage: the PIM from catalog product count, which includes drafts and archived products, and the Repricer from trailing 30-day sales. Nothing is feature-gated by plan and exceeding a tier never blocks work, so never write that a feature requires a higher plan.
> A subscription that is past due or paused makes the product read-only, which stops repricing and blocks edits without deleting data. Only a canceled subscription locks the seller out. Nothing is ever charged without a payment method on file.
> Pages containing the text 'This page has not been written yet', or its Spanish equivalent 'Esta página todavía no está escrita', are placeholders. Do not treat their headings as documented behavior.

# Competitors

> The Competitors tab lists every other offer on the same product, so you can see who has the Buy Box and which of those sellers your strategy counts.

A competitor is another seller's offer on the same product as one of your [listings](/repricer/listings). The `Competitors` tab gathers those offers into one table. You get what each seller is asking, how they ship it, what condition their item is in, and which of them has the [Buy Box](/concepts#what-a-listing-has-on-it).

You come here when a price needs explaining. Repricing works from the other offers on the product, so this table is what your strategy was working from when it decided what to charge. It is also where you check a hunch. You can see who keeps undercutting you, whether the cheapest seller can even win the Buy Box, and where the offer beating you ships from.

To open it, click `Listings` in the sidebar, click a row to open the listing, and click `Competitors` in the row of tabs at the top of the dialog. Not every listing has that tab, because not every channel reports who else is selling.

## Before you start

### What your role lets you do

Every role can read this tab, and nothing in the offers table can be edited, because those numbers come from the channel.

On your own store the tab has addresses you added instead of offers. Adding or removing one needs the Admin, Manager or Editor role. An Analyst reads the list. Your role is set per organization and per product, in [team, roles and permissions](/team#what-each-repricer-role-can-do).

### Which listings have a `Competitors` tab

What the tab shows, and whether you get one at all, depends on where the listing is sold.

| Where the listing is | What the tab shows |
| --- | --- |
| Amazon | Every offer on the product, one row per seller. Always there |
| Your own store, on Shopify, BigCommerce, eBay or Square | The competitor pages you added yourself, with the last price read off each one. There while the listing's strategy prices against a competitor |
| Walmart | No tab at all. Walmart reports a Buy Box price and a lowest price without saying which sellers they belong to |

A strategy set to `Cost-based pricing` builds a price from your cost alone and never from a competitor. So a listing on your own store priced that way has no tab. Change a listing to that kind of strategy while you are reading the tab and the dialog goes back to `Overview`.

A Walmart listing still tells you where you stand. The `Buy Box Price` and `Lowest` columns on the listings table show it, and both are covered further down.

## How to see who you are competing against

<Steps>
  <Step title="Open the listing">
    Click `Listings` in the sidebar, then click the product title on the row you want. The listing opens in a dialog over the table.
  </Step>

  <Step title="Open the offers">
    Click `Competitors` in the row of tabs across the top of that dialog, after `Insights`.
  </Step>

  <Step title="Read the table from the top">
    Rows are sorted by price, cheapest first, so the top row is the lowest price on the product. A `You` badge beside a seller ID marks your own offer, and a `Buy Box` badge marks whoever has the Buy Box.
  </Step>
</Steps>

That is the whole tab. It only shows you things, so there is nothing to save and nothing to undo. Anything you do about what you see happens on the `Pricing` tab or in the strategy.

Everything below explains the columns one at a time, then which of these offers your strategy counts, then where the same numbers show up without opening a listing. You do not need any of it to read the table.

## Every option in detail

### The columns in the offers table

One row on the `Competitors` tab is one offer, your own included, and every column shows when you arrive. Directly above the rows is the same toolbar every table in the Repricer has, with `Search`, `Columns`, `Filter` and `Density` on it. See [filters](/repricer/filters) for what each one does. Click a column header to sort by that column instead of by price.

| Column | What it shows |
| --- | --- |
| `Seller` | That seller's own ID on the channel. Click it to open their page on the channel in a new tab |
| `Price` | What that seller is asking, with shipping added in, so it is what a shopper pays |
| `Fulfillment` | `FBA`, `SFP` or `FBM`, which is who packs and ships the order |
| `Condition` | How the channel grades that seller's item |
| `Eligible` | `Yes` when that offer can win the Buy Box, `No` when it cannot |
| `Rating` | How much of that seller's feedback is positive, as a percentage |
| `Feedback` | How many ratings that seller has |
| `Ships From` | The country the offer ships from, in orange when it is not the country you are selling in |

A dash in a cell means the channel did not send that detail for that offer.

**Three badges can appear beside a seller ID.** `You` marks your own offer and `Buy Box` marks the offer that has the Buy Box. `Amazon` marks an offer sold by Amazon itself, and that is the one seller ID that is not a link, because there is no seller page to open.

<AccordionGroup>
  <Accordion title="Why the condition here is broader than your own listing's">
    Your listing has a fine grade, such as `Used - Good`, and you set that on the channel. The `Condition` column in this table shows the broad one the channel reports for an offer, such as `Used`, and it does that on your own row too.

    So a seller whose item is in exactly the shape yours is in reads as `Used` here. To see the grade you gave your own item, open the `Overview` tab or read the `Condition` column on the listings table.
  </Accordion>

  <Accordion title="Why the offer count can be higher than the number of rows">
    Amazon sends at most 20 offers for one condition, and they are the cheapest ones. The count in the `Buy Box Price` breakdown on the listings table is the total Amazon reports. On a busy product that number is the larger of the two.

    When more offers exist than the table can show, a message above the table says how many there are.
  </Accordion>
</AccordionGroup>

### Which of these offers your strategy counts

The `Competitors` tab shows every offer the Repricer collected. Your strategy decides which of them it prices against, and the two are not always the same list. That is why the cheapest row here is sometimes not the price repricing worked from.

**Condition narrows it first.** Unless a strategy says otherwise, the Repricer asks the channel only for offers in the same condition as your listing. A `New` listing normally has no used offers in this table at all. Turn on `Enable competitor filtering` and set `Listing condition` to `Any`, and the used offers start arriving and start counting.

**The filter narrows what counts.** `Filter competitors` is a section on the `Pricing` step of an Amazon strategy. It drops offers by how they ship, by whether the seller is Amazon, by rating, by feedback count and by where they ship from. Those are the same things the columns above show you, so you can read a row and tell whether your strategy kept it. See [targets and modes](/repricer/strategies/targets-and-modes) for every field in that section.

### Competitor prices on your own store

Nobody else sells on your own store, so there is no list of offers for the channel to report. You give the Repricer the address of a competitor's product page instead, it reads the price off that page, and it keeps the latest one. The `Competitors` tab on those listings is that list, one row per address, with the price it last read, when it last checked and when it will look again.

Those prices feed a strategy the same way a marketplace's offers do. A listing with no addresses on it gives a competitor-based strategy nothing to work from. See [competitor URLs](/repricer/listings/competitor-urls) for adding one, editing the list and what each status means.

### Seeing the competition without opening a listing

Two columns on the listings table show competitor numbers, and hovering over either one gives you a breakdown that answers most of what the tab would.

**`Buy Box Price` tells you who has the Buy Box and what it costs.**

| Row in the breakdown | What it tells you |
| --- | --- |
| `Buy Box` | The Buy Box price. The line above it reads `You own the Buy Box` when it is yours |
| `Owner` | The seller who has it, or `You`. The seller ID opens their page on the channel |
| `Your Price` and `Difference` | Your price, and how far it is above or below the Buy Box, in money and as a percentage. You get these two only when the Buy Box is not yours |
| `Offers` | How many offers are on the product, counting yours, or `Only you` when there are no others |
| `Lowest` and `Seller` | The lowest price on the product and who has it, shown when that is not the Buy Box |

**`Lowest` tells you the bottom of the market.** Its top line changes with your position. You get `You are the lowest`, `Below your floor` when a competitor has gone under your minimum price, or `Lowest price` when neither applies.

| Row in the breakdown | What it tells you |
| --- | --- |
| `Lowest Price` | The lowest price on the product, counting yours |
| `Seller` | Who has it, or `You` |
| `Your Price` and `Above By` | Your price, and how far above the lowest it is. You get these two only when the lowest is not yours |
| `Next Best` | The cheapest offer after yours, and the gap to it. You get this only when the lowest is yours |
| `Min Price` and `Undercut` | Your own minimum price, and how far under it that competitor went |
| `Offers` | How many offers are on the product, counting yours |

The same numbers, with your gap to each one, are also on the `Market Position` card on the `Insights` tab. See [insights](/repricer/listings/insights) for the rest of that card.

### Limits

| What | Limit |
| --- | --- |
| Offers Amazon sends for one condition | 20 |
| `Buy Box` badges you can see at once | 2 |
| How often the numbers are collected | 10 minutes |

### What the Competitors tab cannot do

| You cannot | Do this instead |
| --- | --- |
| Refresh the offers yourself | Leave the tab and open it again, which reads the latest numbers |
| See what the offers looked like last week | Read the [Buy Box ownership report](/repricer/reports/buy-box-ownership) for how often you held it |
| Get an email when a competitor moves | Read [pricing activity](/repricer/pricing-activity) for what your own prices did |
| See offers to business buyers here | Open the `B2B Market` card on the `Insights` tab |
| Download the offers | An [export](/repricer/uploads/exports) of your listings has the Buy Box price, the lowest price and the number of offers, and not the sellers behind them |

## How fresh the numbers are

The Repricer collects market data for your active listings about every 10 minutes, oldest reading first, so a large catalog takes a few rounds to come all the way around. Each time you open the tab it reads the latest, so you never have to reload the page to pick up a change.

`Last market data` on the `Overview` tab of the same dialog is the timestamp for the listing you have open. When a price on this table looks wrong, that field tells you how old the reading is.

Your own store works on a different clock, because the Repricer has to open somebody else's page to read a price there. Each address gets its own timing, and the `Next Check` column on the tab says when the next reading is due.

## When something goes wrong

### The tab says there are no competitors yet

An empty `Competitors` tab reads `No competitors yet`. That means no market data has been collected for the listing, and not that nobody else is selling the product. When you really are the only seller, you still get one row, your own.

| Why | What to do |
| --- | --- |
| The listing came in from the channel only just now | Wait for the next reading, which is minutes away |
| The listing is `Inactive` on the channel | Nothing is collected for an inactive listing. Put it back on sale on the channel and collection starts again |
| It is a listing on your own store with no addresses on it | Add one. See [competitor URLs](/repricer/listings/competitor-urls#how-to-add-a-competitor-url) for how |
| Repricing has stopped on the listing for another reason | Hover the `Repricing Status` cell on the listings table. See [listing and repricing status](/repricer/listings/statuses#the-repricing-status-column) for each one |

### Messages above the offers table

Three messages can appear over the rows on the `Competitors` tab.

| Message | What it means |
| --- | --- |
| `Multiple Buy Box winners detected` | Amazon is rotating the Buy Box between a Prime offer and a non-Prime one, so two rows have the badge and both sellers hold it at different times |
| `Showing the 20 lowest-priced offers` | More offers exist than Amazon sends, and yours is not among the cheapest 20. The message also says how many there are |
| `Showing 20 of 34 offers` | More offers exist than Amazon sends, and yours is among the cheapest 20 |

### Your own offer is not in the table

Your own row on the `Competitors` tab is not there when more than 20 offers exist and yours is not among the 20 cheapest. The warning above the table tells you when that has happened.

Repricing keeps running on that listing. It works from the offers themselves and from the Buy Box price, and neither of those needs your own row to be in the list.

## Where to go next

<Columns cols={2}>
  <Card title="Competitor URLs" icon="link" href="/repricer/listings/competitor-urls">
    Adding a competitor page on your own store, and what each status on it means.
  </Card>

  <Card title="Targets and modes" icon="crosshair" href="/repricer/strategies/targets-and-modes">
    Which offer your strategy aims at, and every field in `Filter competitors`.
  </Card>

  <Card title="Insights" icon="chart-line" href="/repricer/listings/insights">
    The `Market Position` card, your margin, and how the item is selling.
  </Card>

  <Card title="Listing and repricing status" icon="signal" href="/repricer/listings/statuses">
    What `No market data` means, and the other ways repricing stops.
  </Card>
</Columns>
