> ## 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.
# The interface
> The sidebar and the header are on every Repricer screen, and between them you move around, search, change organization and open your own settings.
Every screen in the Repricer has the same frame around it. A sidebar down the left takes you between the parts of the product. A header across the top names where you are and has your account on it. A strip under the header shows anything the Repricer needs to tell your whole organization. The page you opened fills the rest, and it is the only part that scrolls.
You use the frame for two kinds of thing. The first is getting somewhere, which is the sidebar, the second list inside `Uploads`, and the search in the header. The second is everything that is not about one screen. That covers which organization you are in, who you are signed in as, which emails you get, and whether the prices the Repricer calculates are going to your channels yet.
The frame is the same on every screen and there is nothing to set up. It folds up in a browser window under 900 pixels wide, and on a phone, and each section below says what moves.
## Before you start
Your role decides three things about the frame, and nothing else on this page depends on it.
| What you are looking for | Who gets it |
| --- | --- |
| `Integrations` in the sidebar | Admin only. Everyone else has 6 entries instead of 7 |
| The `Go Live` button on the preview banner | Admin only. Everyone else reads the banner and asks an Admin |
| The button on a billing banner | Admin only. Everyone else reads the banner and asks the organization owner |
The Repricer has four roles: Admin, Manager, Editor and Analyst. Your role is set per organization and per product, which is why the same account can see `Integrations` in one organization and not in another. Roles are set in [team, roles and permissions](/team).
## How to find your way around
The sidebar runs down the left of every screen. Click one of its entries: `Home`, `Listings`, `Strategies`, `Pricing Activity`, `Reports`, `Uploads` or `Integrations`. The one you are in stays marked while you work.
`Uploads` opens with a second list, between the sidebar and the page. Click `Imports`, `Exports` or `Schedules` in it.
`Search` is in the header, to the right of the page title, and it is there on every screen. Click it, or press `Ctrl+K`, which reads `⌘K` on a Mac.
Your avatar is the circle at the far right of the header. Click it for `Docs`, `Feedback`, `Homepage`, `Settings` and `Sign out`.
That is the whole frame. The sidebar gets you to a section, `Uploads` adds a list of its own, and the header gets you to search and to your account. Anything the Repricer needs to tell you arrives on its own.
Everything below explains those pieces one at a time, and the last two sections cover the messages that appear over your page. You do not need any of it to move around.
## Every option in detail
### The sidebar
The sidebar runs down the left of every screen, with your organization at the top of it and the sections of the Repricer under that. A short bar marks the entry you are in.
The entries and their order are fixed. You cannot add one, hide one, rename one or drag one into a different position, and no setting anywhere in the Repricer changes that.
Two of the entries need a word of explanation. `Home` opens the front page of the Repricer, where the header reads `Dashboard` instead, so the two words mean the same screen. `Uploads` stays marked while you are on `Imports`, `Exports` or `Schedules`, because all three are inside it.
What each section has in it is the table in [getting started with Repricer](/repricer/index).
### The second list inside Uploads
`Uploads` is the one section that opens with a list of its own, between the sidebar and the page. That list is how you open the three screens inside it.
| Entry in the list | What that screen is for |
| --- | --- |
| `Imports` | Bringing your costs, your prices and your rules in from a file |
| `Exports` | Taking your listings back out as a file |
| `Schedules` | An import that repeats on its own, instead of one you start yourself |
The three switch without loading a page, so moving between them is instant. Every role opens all three. What changes is what you can do once you are there, and each of the three pages says so: [imports](/repricer/uploads/imports), [exports](/repricer/uploads/exports) and [schedules](/repricer/uploads/schedules).
The page title in the header follows this list rather than the sidebar. Open `Exports` and the header reads `Exports`, not `Uploads`.
### Switching organizations
The card at the very top of the sidebar is the organization switcher. It shows the name of the organization you are working in, a badge, and a pair of small arrows.
Click that card and a panel opens under a heading reading `Organizations`, listing every organization your account is in. A check mark is beside the one you are already in, and that row cannot be clicked.
Click any other name and the Repricer switches to it. Your listings, your strategies, your integrations, your uploads and your reports all change at once, because everything in the Repricer is owned by one organization.
`Create Organization` is at the bottom of that same panel. Clicking it sends you to the account app, because organizations are made there and not here.
Your role is set per organization and per product, so switching can change what your sidebar shows. An account that is Admin in one organization and Analyst in another loses the `Integrations` entry on the way across.
The badge names what the organization is on. It reads `Trial` while a trial is running, and `Free` when the organization is on no paid plan. Otherwise it names the plan itself, and [plans and billing](/billing) explains where that name comes from.
### The header
The header runs across the top of every screen, to the right of the sidebar. It names where you are on the left and has your account on the right.
| Control | Where it is | What it does |
| --- | --- | --- |
| The page title | The far left | Names the screen you are on, and keeps up as you move |
| The screen's own control | Right of the title | `Listings`, `Strategies` and `Pricing Activity` put their [saved views](/repricer/saved-views) picker there. `Home`, `Reports` and `Integrations` put their [filters](/repricer/filters) there |
| `Search` | Right of that | Opens [search](/repricer/search) over your listings, your strategies and the rest of the app |
| The apps grid | Right of `Search` | A button of small squares, named `Tools`. It opens the Ready for Commerce launcher in the account app |
| Your avatar | The far right | Opens the menu below |
Search is the one control that changes the header rather than adding to it. Click `Search` and the whole left side becomes a box you type into, with `Close` and `ESC` on the right of it. Your page is still there underneath, and closing the search puts you back on it.
### The avatar menu
Your avatar is the circle at the far right of the header, showing your initials. Click it and a short menu opens.
| Item | Where it takes you |
| --- | --- |
| Your name, with your role under it | Your profile in the account app |
| `Docs` | This documentation |
| `Feedback` | The form further down this page |
| `Homepage` | The Ready for Commerce website |
| `Settings` | The Repricer's own settings, further down this page |
| `Sign out` | Ends your session |
The name at the top is your first and last name, or your email address when you have not set a name, with your role in the Repricer under it.
**`Settings` and `Feedback` open over the page** instead of taking you off it. Whatever you had open stays open behind them, and `Esc` closes them again.
**`Sign out` signs you out of every Ready for Commerce app**, not only the Repricer, and takes you to the sign-in screen. Signing in again gets all of them back.
`Settings` has an address of its own even though it opens over the page, and that address names the section you are looking at. So a link to your notification switches can be pasted into a message to a teammate, and it opens on the right section for them.
The feedback form has an address too, and it always opens the form empty.
### Choosing light or dark, and which emails you get
`Settings` in the avatar menu opens a dialog with two sections listed down its left side: `Notifications` and `Appearance`. Those two are everything the Repricer keeps about you. Your name, your team, your organization and your plan are in the account app.
**`Appearance` has one control**, `Color Mode`, with `Light`, `Dark` and `System`, where `System` follows whatever your computer is set to. The header has no switch for this, so `Appearance` is the only place you can set it.
Your choice is kept in the browser you are using and not on your account, so it does not follow you to another computer.
**`Notifications` has five switches**, in two groups. All five start on, all five can be turned off, and each one saves the moment you flip it.
| Group | The switches in it |
| --- | --- |
| `Integrations & Sync` | `Connection issues`, `Listings removed`, and `Sync errors` |
| `System` | `Export ready`, and `Import complete` |
| Switch | You get an email when |
| --- | --- |
| `Connection issues` | An connected account needs reconnecting or reauthorizing |
| `Listings removed` | A sync drops listings for good, because the channel no longer returns them |
| `Sync errors` | A sync of your listings or your data runs into a problem |
| `Export ready` | An export you asked for is ready to download |
| `Import complete` | An import finishes |
Those five cover the Repricer's own work. The email Ready for Commerce sends you about your account, your team and your billing is a separate set of switches in the account app, listed in [profile and preferences](/profile).
### Sending us feedback
`Feedback` in the avatar menu opens a dialog called `Send Feedback`. It is the only way to write to us from inside the Repricer, which has no chat and no help button.
| Field | What you put in it |
| --- | --- |
| `Type` | `Bug Report`, `Feature Request`, `Improvement`, `Question` or `Other` |
| `Priority` | `Low`, `Medium`, `High` or `Critical` |
| `Subject` | One line summing it up |
| `Description` | What happened, or what you would like |
| `Attachments` | Screenshots, a screen recording or a PDF, dropped on the box or picked from your computer |
Everything above the attachments is required. `Submit` sends it and `Cancel` closes without sending. While it is sending you cannot close the dialog, so `Esc` stops working until it is done.
What you send comes to us as an email, and it goes one way. There is no ticket number, nothing to check on later, and no reply inside the app.
`.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.mp4`, `.webm`, `.mov` and `.pdf`.
Drop anything else on the box and it is rejected right there, with a message listing what is accepted.
### On a phone or a narrow window
Under 900 pixels wide the frame folds up, and it unfolds again the moment the dialog is wide enough.
| What | Where it goes |
| --- | --- |
| The sidebar | Behind a menu button at the top left of the header. It closes itself as soon as you pick something out of it, and it gains a `Feedback` link at the bottom |
| The `Uploads` list | Behind the page title, which becomes a button with a small arrow. Press it and the list slides up from the bottom of the screen |
| The filters on `Home`, `Reports` and `Integrations` | Behind a `Filters` button beside the title, which opens them from the bottom of the screen |
The [saved views](/repricer/saved-views) picker is the one control that does not move. It stays beside the page title, and the buttons that go with it collapse behind a small button of three dots.
### Limits
| What | Limit |
| --- | --- |
| A feedback subject | 200 characters |
| A feedback description | 5,000 characters |
| Attachments on one message | 5 |
| One attachment | 10 MB |
| How long a message at the bottom of the screen stays | 5 seconds |
| Where the frame folds up | 900 pixels wide |
### What the interface cannot do
| You cannot | Do this instead |
| --- | --- |
| Reorder, rename or hide a sidebar entry | Nothing. The entries and their order are the same for everyone |
| Switch light and dark from the header | Open `Settings` from the avatar menu and go to `Appearance` |
| Close a banner | Fix what it names, and the banner goes on its own |
| Put an integration back into preview mode | Nothing. Read the confirmation before you click `Go Live` |
| Read a message at the bottom of the screen after it clears | Turn the matching email on in `Settings`, under `Notifications` |
| Create an organization here | `Create Organization` in the switcher sends you to the account app |
| Change your name, your team, your organization or your plan here | All four are in the account app |
| Follow up on feedback you sent | Send another one |
## What appears over your page
Two kinds of message find you wherever you are in the Repricer, and neither one is tied to the screen you happen to be on.
A banner appears in a strip between the header and your page, and it stays there until the thing it names is fixed. A short message appears at the bottom of the screen when a sync you started earlier ends, and it clears itself.
Several banners can be up at once, and they always come in the same order: billing first, then preview mode, then missing data, then the two about your PIM. A billing banner hides the three under it, because a subscription problem stops the repricing those three are about. Search hides all of them, so the strip is gone while you have the search box open, and it comes back when you close it.
### Billing banners
One billing banner shows at a time, and it is the most serious one that currently applies. They are listed here in that order, most serious first.
| Title | It appears when |
| --- | --- |
| `Subscription Canceled` | The subscription was canceled and the product is locked |
| `Payment Failed` | The payment is past due |
| `Trial Ended`, or `Subscription Paused` | The trial ran out, or the subscription was paused for another reason |
| `Trial Ends Tomorrow` | 1 day of trial is left and no payment method is on file |
| A title counting the days of trial left | Between 2 and 7 days are left and no payment method is on file |
The last two are the only ones you can stop before they arrive. Add a payment method and neither of them appears at all.
**Everyone in the organization sees the banner.** An Admin gets it with a button on it. That button reads `Add Payment`, `Update Payment` or `Manage Billing`, depending on the state, and all three open the account app.
Everyone else reads the same warning with a line telling them to contact the organization owner, who is the one person who can change a subscription.
What each state stops is worked through in [plans and billing](/billing).
### The preview banner
`Preview Mode` is the banner every new organization meets. It tells you the Repricer is calculating prices for your listings and is not sending them to your channels yet. That is the state a newly connected integration starts in.
**An Admin gets a `Go Live` button on it.** Click it and a dialog asks you to confirm, one integration at a time or several at once. From that moment the prices go to the channel for real.
Going live cannot be undone. Check your strategies, your costs and your floor and ceiling prices first, because the next calculated price for an integration you activate is sent to the channel.
Everyone else reads the same banner with a line telling them to contact an Admin. The banner goes on its own once every connected integration is live.
### The missing-data banner
A banner reading `Repricing paused for 12 listings`, with your own count in it, means the Repricer has stopped repricing those listings, because a number it needs is not there.
Every strategy needs a price floor, which is the lowest price it will ever set. A strategy either builds that floor out of your cost, or takes a minimum price you typed in yourself. Whichever of the two your strategy uses is the one that has to be filled in, so the banner is telling you which one is empty.
| What the banner says is missing | The field to fill in | Where it is |
| --- | --- | --- |
| Cost | `Unit Cost` | On the listing, under `Cost of Goods` |
| Min price | `Minimum Price` | On the listing, under `Price Limits` |
| Both | Both fields, on different listings | Open each listing from `View Listings` |
`View Listings` on the banner opens your listings already filtered to the ones it counted, so you do not have to find them yourself. Fill the missing number in and repricing starts again for those listings, and the banner goes. [Cost, fees and profit](/repricer/listings/costs-and-fees#where-your-cost-comes-from) explains where a cost comes from, and [the price floor and ceiling](/repricer/strategies/price-floor) explains which of the two your strategy is using.
### PIM coverage banners
Two more banners appear only for an Admin, and only when your Repricer and your PIM disagree about a connected account. Each one names the accounts it is about.
| Title | It appears when | The button on it |
| --- | --- | --- |
| `Activate the PIM integration` | The same connected account is connected in both products while the link between them is off, so both are publishing prices to the same place and can overwrite each other | `Activate integration`, which opens [the PIM connection](/repricer/integrations/pim) here |
| `Channel connected only in the PIM` | An connected account exists in the PIM and not here, so the two cannot be paired | `Connect channel`, which goes right to that integration's connect screen. Where more than one integration is involved it reads `View integrations` and takes you to the list |
No banner of any kind has a close button, and none of them needs a reload. The strip works out what applies on its own, within a minute of anything changing.
### Messages at the bottom of the screen
One thing the Repricer runs in the background announces itself wherever you are: the first sync of a newly connected integration. When that sync ends you get `Initial sync complete.` or `Initial sync failed.` at the bottom of whatever screen you are on, and it clears itself after 5 seconds.
You do not get it while you are on `Integrations`, because the sync dialog on that screen is already telling you the same thing in more detail.
A message only appears if you have the Repricer open when the sync ends. Nothing is kept and there is no history, so email is what tells you about work that finished while you were away.
Everything else the Repricer runs in the background reports itself on the screen you started it from. An import you leave and come back to shows its result in the [imports](/repricer/uploads/imports#reading-the-imports-table) table, and an export in the [exports](/repricer/uploads/exports#reading-the-exports-table) table.
## When something goes wrong
### A banner is still there after you fixed it
The strip works out what applies within a minute, so give it that long before reloading. If the banner is still up after that, the thing it names is still true. A payment method you added in the account app may not have been accepted. The PIM account it points at may still not be connected here. A listing you thought you filled in may still be short a number.
### A message in the feedback form
| Message | What to do |
| --- | --- |
| `This field is required` | You left `Subject` or `Description` empty. Fill it in |
| `Invalid value` | You left `Type` or `Priority` unpicked. Pick one of each |
| `Must be at least 3 characters` | Your `Subject` is too short |
| `Must be at least 10 characters` | Your `Description` is too short |
| `Invalid file type`, with a list of what is accepted | The file is not one of the kinds listed further up. Convert it, or describe it in words instead |
| `File too large`, with a size | The file is over 10 MB. Send a shorter recording, or a screenshot |
| `Maximum 5 files allowed.` | You already attached 5. Remove one first |
| `Failed to submit feedback.` | Nothing was sent, so try again |
| `Something went wrong. Please try again.` | Nothing was sent, so try again |
When it does send, a message at the bottom of the screen tells you so and the dialog closes itself.
### A notification switch will not stay flipped
`Failed to update preference` appears at the bottom of the screen and the switch goes back to where it was. Nothing was saved, so flip it again.
If the whole section shows `Unable to load notification settings` instead of the switches, close `Settings` from the avatar menu and open it again.
### No one told you an import or an export finished
A message at the bottom of the screen only ever announces a first sync. An import or an export that ends while you are elsewhere tells you by email instead.
Open `Settings` from the avatar menu, go to `Notifications`, and turn on `Import complete` and `Export ready`.
## Where to go next
What each of the seven sections has in it, and what your role opens.
What `Ctrl+K` covers across the app, and what it leaves out.
The four roles that decide what your sidebar shows.
What each banner state stops, and what it does not.