Listings

Pricing on a listing

The minimum, the maximum, the MAP, the MSRP and the manual price you put on a listing are the limits your strategy works inside, and you set them here.

Every listing has a small set of price numbers of its own. The lowest price you will sell it for, the highest, the manufacturer’s MAP and MSRP, and a fixed price you can set yourself. None of these is a price a shopper ever sees. They are the numbers your strategy has to work inside.

That split is the thing to get straight first. A strategy decides how to price, and one strategy usually covers hundreds of listings. These numbers decide how far it can go on this one listing. So two listings on the same strategy come out at different prices, because what you typed here is different.

Two of the fields do more than set a limit. A manual price takes the listing out of repricing and keeps your number, and the Pause Repricing switch stops repricing without a number at all.

You get to all of it from Listings, in the sidebar down the left. Click a row and that listing opens in a dialog with tabs across the top. The second tab is Pricing, and everything on this page is on it. There is no Save button anywhere on that tab, because each field saves itself.

Before you start

What your role lets you do

Everyone can open the Pricing tab on a listing and read every number on it. What changes with your role is what you can change.

What you want to do	The lowest role that can
Read every number on the tab	`Analyst`
Type into a price field	`Editor`
Change the strategy, or use `Pause Repricing`	`Manager`

Below your role, nothing disappears. A price field you cannot change is still there, still readable, in a box with a dashed edge you cannot type into, and Pause Repricing is grayed out. Roles are set in team, roles and permissions.

A manual price turns your strategy off

With a number in Manual Price, on the Pricing tab, the listing stays at that price. Your strategy and every limit on that tab are skipped, the minimum and the maximum included. Clear the field to reprice again.

How to get a listing repricing

Open the listing
Click Listings in the sidebar down the left. Click any cell in the row except Cost, Manual Price, Min, Max, MAP or MSRP, because those six columns open an edit inside the table instead. The listing opens in a dialog.
Go to the Pricing tab
The tabs run across the top of the dialog. Click Pricing, the second one. You get two columns of cards.
Read the strategy on the listing
Strategy is the first card in the left column. It is a dropdown, and the name in it is the strategy pricing this listing right now. Pick another if you want a different one.
Fill in the number your strategy needs
In the right column, find the card called Price Limits and type your lowest acceptable price into Minimum Price.
Some strategies calculate that floor from your cost. If Minimum Price is a box you cannot type into with Auto beside it, that is what yours does. Put your cost into Unit Cost instead, under Cost of Goods, at the top of the same column.
Click somewhere outside the field
Saved appears inside the field for a moment. That is the whole save.

That is all it takes. Saving that number queues this listing for repricing right away, so there is no scheduled run to wait for. Its Repricing Status in the listings table changes from Not working to Working.

Everything below goes through the tab one card at a time, then explains what the repricer does with the numbers. You do not need any of it for the common case.

Every field in detail

The Pricing tab is two columns. The left column has the two controls that decide whether the repricer touches this listing at all. The right column has the numbers, in four cards from the top: Cost of Goods, Selling Price, Price Limits and Manufacturer Pricing.

Not every card is on every listing. Two of them depend on the strategy you picked, and each section below says when one of them is missing.

Picking the strategy for this listing

Strategy is the first card in the left column of the Pricing tab, and it is a dropdown. Open it and you get the strategies built for this listing’s region, and only those. Pick one and it applies to this listing right away, with nothing to confirm.

Your listings do not start empty. A listing gets its region’s default strategy when it first arrives, so there is a name in this dropdown before you touch anything.

Two things can happen instead of a list of names. If your role is below Manager, the dropdown reads the name and does not open. If nothing has been built for this region yet, the dropdown is grayed out and reads No strategies for this region. Hover it and it tells you to create one on the strategies page.

Which strategy you pick changes the rest of the tab, which is why it is worth reading first. It decides three things. Whether you type your minimum price or the repricer calculates it, whether Price Limits appears at all, and whether your MAP and MSRP do anything. How a strategy is built is covered in strategies.

Pausing repricing on one listing

Pause Repricing is the second card in the left column of the Pricing tab, with a switch on the right of it. Turn it on and the repricer stops changing this listing’s price. The card turns amber so you can see the state from across the tab.

Nothing else changes. Your price on the channel stays where it is, every number on the tab keeps its value, and turning the switch off starts repricing again. This is the setting for a listing you want to leave alone for a week, not for one you want at a price of your own.

Pause and a manual price are not the same thing, and picking the wrong one is the common mistake. Use Pause Repricing when you want today’s price frozen and you do not care what the number is. Use Manual Price when you have a number in mind. A paused listing shows Paused in your listings table and a manual one shows Manual.

Setting a price of your own

Manual Price is the first field in the Selling Price card, second down the right column of the Pricing tab. Type a price into it and the repricer publishes exactly that, over and over, until you clear the field.

A manual price is the strongest setting on the tab. Your strategy does not run, no competitor price is read, and none of the limits below it apply. So a manual price under your minimum price still goes out. The field is there for a listing whose price you have already decided yourself.

Clear the field to go back. Delete what is in it, click outside, and the listing is repriced by its strategy again, starting right away.

One warning appears under this field and does not stop anything. Type a manual price below your Unit Cost and you get Below your cost in amber. The price still saves and still goes out.

Setting the floor and the ceiling

Price Limits is the third card down the right column of the Pricing tab, with two fields in it.

Field	What it does
`Minimum Price`	The lowest price the repricer will ever publish for this listing
`Maximum Price`	The highest price it will ever publish

A minimum price is the number most listings are waiting on. Some strategies take the floor from you instead of from your cost. On one of those, a listing with no minimum price does not reprice at all. It shows Not working in your listings table until you type a number here.

A maximum price is never required, and a listing reprices without one. Fill one in anyway when your strategy raises prices. A listing that is winning the Buy Box gets pushed up a little at a time to earn more per sale. The maximum is what tells it where to stop.

The two are checked against each other while you type. A minimum above the maximum turns both fields red, with Must be ≤ max under one and Must be ≥ min under the other. Neither saves until you fix it.

This card is missing on a store of your own whose strategy prices from your cost. That kind of strategy builds the price out of your cost and a markup, so there is no floor and no ceiling to set.

When your minimum price is calculated for you

Some strategies calculate the floor themselves, from your cost and the profit you asked for. On a listing with one of those, Minimum Price in the Price Limits card is a box with a dashed edge that you cannot type into. A small Auto label is to the right of it, and the number in the box is the floor the repricer calculated.

Hover the Auto label and you get the whole calculation in words: which strategy did it, the target it is protecting, and the cost and estimated fees it used. When your cost is empty, that same tooltip tells you so, which is your sign that the field you actually need is Unit Cost.

To type your own minimum again, change the strategy, not the listing. The floor is a strategy setting, so a listing cannot opt out of it on its own. Either assign this listing a strategy whose floor you set yourself, or change the one it is on. Price floor covers both.

The number in the box moves on its own. Change your cost and the calculated floor changes with it, in front of you, without a reload.

Showing a crossed-out price on your own store

Compare Price is the second field in the Selling Price card, on the Pricing tab. It is the higher, crossed-out price your store shows next to what you are charging, so a shopper reads the difference as a discount.

You only get this field on a store of your own, and only when the strategy on the listing sets a compare price. Everywhere else it is not on the tab.

What you can do with it depends on which compare price your strategy uses.

Your strategy is set to	What you get here
Setting it manually	An empty field you type the price into
Calculating it	A box you cannot type into, with `Auto` beside it and the calculated price in it

Hover that Auto label and you get the strategy’s name and how it got the number, including the markup it added if that is the mode you are on.

A compare price has to be above the price you are charging, or a shopper sees a discount that is not one. So a compare price at or below your Manual Price turns both fields red. You get Must be > manual price under one and Must be < compare price under the other.

Empty the field and the crossed-out price is taken off your store. The same happens on its own whenever the price you charge rises to meet the compare price, for the same reason.

Recording the manufacturer’s MAP and MSRP

Manufacturer Pricing is the last card down the right column of the Pricing tab, and it has two fields.

Field	What it is
`MAP`	The lowest price your supplier lets you advertise
`MSRP`	The price the manufacturer suggests you sell at

Typing them in does nothing on its own, and this surprises people. Both are switched off in a new strategy, so a MAP you filled in months ago is only a number until a strategy is told to use it. A strategy can then turn MAP into a floor, cap the price at MSRP, or lock the price to one of the two. Safety nets is where those switches are.

They are also checked against each other. A MAP above the MSRP turns both fields red with Must be ≤ MSRP and Must be ≥ MAP, and nothing saves until one of them moves.

Two amber warnings appear here and stop nothing. A Unit Cost above either number gives you Your cost is above MAP, Your cost is above MSRP, or Your cost is above MAP and MSRP under the cost. Under the manufacturer field itself you get Lower than your cost. Every value still saves.

They are worth reading. A cost above the price you are allowed to advertise means you cannot sell that listing at a profit, and finding that out here beats finding it in a report.

Pricing separately for business buyers

A strategy can price for business buyers as well as ordinary shoppers, and when the one on this listing does, the Pricing tab grows a second set of fields for it. What appears depends on how the strategy prices business orders.

The business pricing fields, and when each one appears

A strategy that gives business buyers one fixed price adds a section called Fixed Business Price at the bottom of the Selling Price card. It has a single B2B Price field in it.

A strategy that prices business orders against the market adds a section called B2B Price Limits at the bottom of the Price Limits card. In it are B2B Minimum Price and B2B Maximum Price.

Those two work exactly like the ordinary minimum and maximum above them, red messages and all. B2B Minimum Price gets the same Auto treatment when the strategy calculates the business floor from your cost.

Business pricing covers what the strategy does with all four.

How each field saves

There is no Save button on the Pricing tab. Every field saves itself, and it saves in three ways: a moment after you stop typing, the instant you click outside the field, and when you close the dialog. Pressing Ctrl+S, or Cmd+S on a Mac, saves everything at once without closing anything.

What you see while that happens is inside the field itself, at the right edge.

What you see	What it means
Nothing	Nothing to save, or you have not finished typing
`Saving`	Your number is on its way
`Saved`	Your number is stored. It fades after a moment
`Error`	Nothing was saved, and a message tells you why

Each field takes digits and a decimal point, up to 2 decimal places. Anything else does not appear as you type, so there is no way to enter a letter, a minus sign or a thousands separator. The currency is your listing’s, shown as a symbol on the left of every field, and you never type it.

To clear a number, empty the field. Delete what is in it, click outside, and the field goes back to having no value. That is different from typing a zero, which is rejected with Enter a valid amount because none of these numbers can be zero.

Six of the fields put the listing back in line to be repriced the moment they save: Unit Cost, Manual Price, Minimum Price, Maximum Price, MAP and MSRP. So a listing you just fixed does not wait. The rest of the tab saves the same way and takes effect at the next run.

Limits

What	Limit
The highest number any field takes	9,999,999.99
The lowest	Anything above zero
Decimal places	2
Strategies on one listing	1

What you cannot do here

You cannot	Do this instead
Publish a price straight to the channel	Type it into `Manual Price`, which the repricer then publishes
Set a minimum or a maximum as a percentage	Type the amount, or have your strategy calculate the floor from your cost
Fill in these fields for many listings at once	Run an import with your numbers in it
Change your strategy’s own settings from here	Open it on the strategies page
Undo a number you replaced	Type the old one back. Nothing on this tab is versioned
See what the repricer will price this listing at next	Read the `Target` column in your listings table
Set a different limit per region or per account	Open each listing. These numbers are per listing
Schedule a price for a date	Nothing here works on a date. The schedule is a strategy setting

What the repricer does with your numbers

The tab records numbers. What turns them into a price is the next repricing run, and the order it works in explains almost every price you did not expect.

The order your limits are applied in

Your strategy calculates a price first, from whatever it prices against. Then that price is pushed inside your limits, one at a time, in this order.

Step	What happens
1	The floor is applied, either your `Minimum Price` or the one calculated from your cost
2	Your `Minimum Price` is applied
3	Your `Maximum Price` is applied
4	Your `MAP` is applied as a floor, if the strategy was told to
5	Your `MSRP` caps the price, if the strategy was told to
6	The profit floor is applied, if the strategy has one
7	The ceilings are applied again, so no floor above can push the price past them

That last step is why a ceiling always beats a floor. Set a minimum price above your MSRP with a strategy capping at MSRP, and the price comes out at the MSRP, because step 7 pulls it back down.

Rounding happens after all of it, so a price you set a limit on can come out a cent or two away from your number. Rounding covers what it does.

What a manual price skips

None of the order above runs when the Manual Price field, in the Selling Price card, has a number in it. Your strategy does not run, no competitor is read, no limit is applied and nothing is rounded. Your number is what goes out.

So the field is worth checking whenever a listing is not doing what you expect. A manual price left on a listing from months ago looks like a broken strategy and is not one, and the listings table says so, because Repricing Status on it reads Manual.

Where these numbers come from besides you

The Pricing tab is not the only place these fields get filled in, which is why a number can be different from the one you remember typing.

It also changes when	What it changes
Someone edits the `Cost`, `Manual Price`, `Min`, `Max`, `MAP` or `MSRP` column straight in the listings table	The same field on this tab
Someone runs an import with those columns in the file	Every listing in the file, matched by SKU
A sync link copies fields from another listing onto this one	Whichever fields that link covers
The listing is matched to a variant in the PIM	Your cost, MAP and MSRP, which the PIM then owns

The activity page is where you find out what the repricer did and why, one price change at a time.

When something goes wrong

A field you cannot type into

Three different things make a field on the Pricing tab read-only, and what is next to the box tells you which.

What you see	What it is	What to do
A dashed box with `Auto` beside it	Your strategy calculates this number	Hover `Auto` to read the calculation, or change the strategy
A dashed box with `Managed by PIM` beside it	The listing is matched to a variant in the PIM, which owns your cost, MAP and MSRP	Click `Managed by PIM`, which opens that variant in the PIM in a new tab
Every price field dashed, and `Pause Repricing` grayed	Your role is below `Editor`	Ask an `Admin` on your team

Managed by PIM only ever appears on three fields, Unit Cost, MAP and MSRP. Everything else on the tab stays yours. The PIM connection covers what the link does and how to switch it off.

The messages under a field

A red message under a field on the Pricing tab means nothing was saved. Fix the number and it saves itself.

Message	What to do
`Enter a valid amount`	You typed a zero, or nothing usable. Type a number above zero, or empty the field
`Maximum is $9,999,999.99`	Your number is too large for the field
`Must be ≤ max` and `Must be ≥ min`	Your minimum is above your maximum. Move one of them
`Must be ≤ MSRP` and `Must be ≥ MAP`	Your MAP is above your MSRP. Move one of them
`Must be > manual price` and `Must be < compare price`	Your compare price is at or below your manual price. Raise the compare price

An amber message means the opposite. Your number saved, and it is telling you something about it.

Message	What it means
`Your cost is above MAP`	You cannot advertise this listing at a price that covers your cost
`Your cost is above MSRP`	The manufacturer’s suggested price is under what you paid
`Your cost is above MAP and MSRP`	Both of the above
`Lower than your cost`	Under `MAP` or `MSRP`, saying the same thing from the other side
`Below your cost`	Under `Manual Price`. You are selling this listing at a loss

The messages at the corner of the screen

A message in the corner is about the save itself and not about the number in the field.

Message	What to do
`Failed to save changes.`	Try the same number again
`You do not have permission.`	Your role is below `Editor`. Ask an `Admin` on your team
`Price and cost values must be greater than zero.`	Type a number above zero, or empty the field
`Cost, MAP and MSRP on this listing are managed by your PIM connection. Edit them in the PIM instead.`	Change the value on the matched variant in the PIM
`Failed to update rule`	Pick the strategy again. The old one is still on the listing
`Failed to update repricing status`	Use `Pause Repricing` again
`Listing not found or access denied.`	Reload the page. The listing may have gone with the account it was on

A number you typed in the table did not stay

Editing one of the six price columns straight in the listings table saves the same way this tab does. One difference is worth knowing about: a save that fails there puts the old number back and tells you nothing.

So if a number you typed into the table is not the number you see a moment later, open the listing and type it on this tab. Here the message explains itself.