> ## 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.

# Organizations

> An organization is where your business works, and your catalog, your integrations, your team and your subscription are all owned by it.

An organization is where your business works. You sign in as a person, and almost nothing you build is yours personally. The catalog, the integrations you connect, the listings the Repricer prices, the team and the subscription are all owned by the organization. Everyone you invite works on the same copy of it.

Your account is you: your name, the email address you sign in with, your language. An organization is the business. One account can be a member of several organizations, with a different role in each, and nothing you do in one shows up in another.

Most people come here for one of three reasons. They are setting up for the first time and have to decide whether to create an organization or join one someone else built. They need to change something about the business, most often its name or the currency it sells in. Or they are in two organizations and want to be sure which one they are looking at.

You will find all of it at [account.readyforcommerce.com](https://account.readyforcommerce.com), on a screen called `My Account`. A sidebar down the left splits it into two groups. The `Account` group is about you, and [profile and preferences](/profile) covers it. The `Organization` group under it is this page, and it lists `General`, `Team` and `Billing`, with `General` as the one where the organization is named and configured.

## Before you start

### What your role lets you do

You have one of three roles in the organization, and it decides how much of this page you can act on.

| What you want to do | Owner | Admin | Member |
| --- | --- | --- | --- |
| Read the settings on `General` | Yes | Yes | Yes |
| Change the name, the currency or the units | Yes | Yes | No |
| Turn on the PIM or the Repricer | Yes | Yes | No |
| Leave the organization | No | Yes | Yes |
| Transfer ownership, or delete the organization | Yes | No | No |

A Member opens `General` and sees the same five settings written as plain text, with no dropdowns, and without the red section at the bottom that deletes the organization. An Admin sees those settings but not `Billing`, which the owner alone can open. So the `Organization` group in the sidebar is two entries long for an admin and three for the owner. The whole set of roles is in [team, roles and permissions](/team).

### Changing the currency converts your prices

<Warning>
  Changing the currency converts every price in your PIM catalog at today's rate. Changing back converts them a second time, so the numbers you started with do not come back. Set it once, early.
</Warning>

## How to set up your organization

<Steps>
  <Step title="Create your organization, or accept an invitation" icon="building">
    The first time you sign in, Ready for Commerce shows you a screen called `Create a new organization`. Type your business name into the `Organization name` field and click `Create organization`. If a teammate already uses Ready for Commerce, do not do this: ask them to invite you, and open the link in the email they send you instead.
  </Step>

  <Step title="Open your organization settings" icon="settings">
    Go to [account.readyforcommerce.com](https://account.readyforcommerce.com), click your avatar in the top right corner, and click the first row of the menu, which shows your name. That opens `My Account`. In the sidebar on the left, under `Organization`, click `General`.
  </Step>

  <Step title="Set the currency you sell in" icon="coins">
    Click the `Currency` field, type the name of the currency or its 3-letter code, and pick it from the list that appears.
  </Step>

  <Step title="Set the units your products start in" icon="ruler">
    Pick from the `Default Weight Unit` and `Default Dimension Unit` dropdowns, lower down the same page.
  </Step>

  <Step title="Invite the rest of your team" icon="users">
    Click `Team` in the same sidebar group, above `Billing`.
  </Step>
</Steps>

That is the whole setup. There is no Save button on any of it, because every field saves itself. You get `Saved` at the right edge of a field when the change is stored, and `Error` in red when it does not.

Everything below explains those settings one at a time, and covers switching between organizations, moving between the two products, leaving one, and deleting one. You do not need any of it to get started.

## Every option in detail

The first section is the decision you make once, at the very beginning. The four after it follow the settings down the `General` page in the order they appear, and the rest cover what you do with an organization after it exists.

### Create an organization, or join the one your teammate built

This is the decision that is hardest to undo, and the one most people get wrong on their first day.

**If no one from your company has signed up yet, you create it.** Creating an organization makes you its Owner. It also gives you Admin access inside both products, so nothing is closed to you later. The screen that asks for the name is titled `Create a new organization`, and it has one field, `Organization name`, and one button, `Create organization`.

You are never asked for your own name here. Ready for Commerce already made one for you when your account was created, out of your email address or out of your Google account. If it came out wrong, [profile and preferences](/profile) is where you correct it.

**If a teammate already uses Ready for Commerce, ask them to invite you.** The email they send has an `Accept invitation` button. Clicking it opens a page showing who invited you and the address the invitation went to. Under a heading called `Your access` it shows the role you are being given. If you are not signed in, you are asked to sign in first, and you come right back to the same page. Click `Accept invitation` there and you are in the organization they already built, with its catalog, its integrations and its data.

Accept with the same address the invitation was sent to. A different address is rejected instead of being let in with no warning, and the invitation lasts 7 days from the day it was sent. Asking for it to be resent gives it another 7.

<Warning>
  Signing up separately does not fail and does not warn you. It creates a second, empty organization with its own subscription, and there is no way to merge two organizations or to move people between them in bulk.
</Warning>

If that has already happened, accept the invitation when it arrives. You are then in both, the switcher moves you between them, and you can delete the empty one.

### Find your organization ID

`Organization ID` is the first field on `General`, the first entry under `Organization` in the `My Account` sidebar. It is the identifier of this one organization, you cannot edit it, and a small copy button is at its right edge.

It is the value to give when you write to `support@readyforcommerce.com` about this organization, since two organizations are allowed to share a name.

### Name your organization

`Organization Name` is the field under the ID on `General`. Type into it and it saves itself a moment after you stop typing, and again when you click away.

The name takes up to 100 characters and any character you can type, so `Peña & Sons, Ltd.` goes in exactly as you wrote it. It cannot be left empty.

The name is what your team sees in the switcher and what appears on your invoices. Changing it changes both, immediately. Nothing else changes: no address changes, no data moves, and no one is signed out.

### Choose the currency you sell in

`Currency` is the third field on the `General` page of `My Account`, and it is a dropdown you can type into. Click it and type the name of a currency or its 3-letter code to narrow the list, then pick one. There are 160 to choose from. `US Dollar`, `Euro`, `British Pound` and `Canadian Dollar` are at the top of the list, and the rest run alphabetically by name.

The currency there now was probably not chosen by anyone. When the organization was created it was guessed from the country you were in, so it is worth checking before you build a catalog rather than after.

**Every price in the PIM is written in this currency**, and none of them has a currency of its own. That is why changing the setting has to convert the catalog: prices, costs, compare-at prices, MAP and MSRP are all converted at today's rate, so the numbers themselves change. A catalog of 500 variants or fewer converts while you wait. A larger one can take about a minute, and until it catches up you still see the old numbers.

**The currency also has to agree with the places you publish to.** A store or a seller account has a currency of its own. The PIM will not send a price to one that is not yours, because a price with no currency attached would be relabeled instead of converted. The connection itself keeps working. What fails is the sync, and the integration then shows a message saying its currency does not match your organization's.

Amazon is the exception, because each Amazon marketplace has its own currency. The PIM prices those from the per-currency prices you set yourself, covered in [pricing](/pim/catalog/pricing), and never from a conversion.

<AccordionGroup>
  <Accordion title="What happens to your per-currency prices when you switch">
    If you have already entered prices in the currency you are switching to, those are the ones you keep. Each becomes the normal price, and the per-currency entry goes away, since it now says the same thing twice.

    Anywhere you have not entered one, the old price is converted at today's rate. The old currency is not kept behind as a per-currency price, so switching there and back is not a round trip.

    Per-currency prices in every other currency are left alone.
  </Accordion>
</AccordionGroup>

### Choose the units new products start in

`Default Weight Unit` and `Default Dimension Unit` are the last two settings on the `General` page of `My Account`, and both are plain dropdowns.

| Dropdown | What it gives you |
| --- | --- |
| `Default Weight Unit` | `Grams (g)`, `Kilograms (kg)`, `Ounces (oz)`, `Pounds (lb)` and `Carats (ct)` |
| `Default Dimension Unit` | `Millimeters (mm)`, `Centimeters (cm)`, `Inches (in)` and `Yards (yd)` |

These two decide where a new variant starts, and nothing else. Change either one and everything already in your catalog stays as it was, in the unit it was entered in. That makes them safe to change at any time, which is the difference worth remembering between them and the currency above.

Pick the unit you type most often, because it is the one you will not have to correct on each new variant.

### Switch between organizations

The switcher decides which organization everything on your screen comes from. There is one wherever you happen to be.

| Where you are | Where the switcher is |
| --- | --- |
| [account.readyforcommerce.com](https://account.readyforcommerce.com) | In the line under the greeting, on the organization's name |
| `My Account`, on `General`, `Team` or `Billing` | A small button at the top right of the screen, level with the title |
| The PIM or the Repricer | At the top of the sidebar, next to a badge showing the plan |

All of them open the same short menu. At the top is a heading reading `Organizations`, then one row for each organization you are a member of, with a check mark on the one you are in. `Create organization` is at the bottom, under a dividing line. The rows are sorted by name.

Your choice follows you everywhere. Switch in your account and the PIM and the Repricer switch with you, so opening either one after that shows the organization you picked. You never have to switch twice.

The menu is there even when you are in one organization only, because it also gives you `Create organization`. Click that and you get the same naming screen described above, and the new organization becomes the one you are in.

If someone removes you from the organization you were last in, nothing breaks and nothing warns you. The next page you open moves you to an organization you are still in.

### Move between your account and the two products

[account.readyforcommerce.com](https://account.readyforcommerce.com) is where you start. Signing in opens a page with one card for each product, the Repricer first and the PIM second, and a card is in one of four states.

| The card | What it means | What to do |
| --- | --- | --- |
| The whole row opens the product, with a status under the name | Your organization has the product, and you have a role in it | Click the row |
| A `Start free trial` button on the right | Your organization has not turned the product on, and you can turn it on | Click `Start free trial` |
| Dimmed, with `No access` under the name and a padlock on the right | Your organization has the product, and you have no role in it | Ask an owner or an admin for a role |
| Dimmed, with `Not activated` under the name and a padlock | Your organization has not turned the product on, and you cannot | Ask an owner or an admin to turn it on |

The line under the product name is the only status you get. While a free trial runs it counts down in days. After that it is the state of the subscription, and [plans and billing](/billing) explains each one.

**Clicking `Start free trial` starts a 30-day trial** and makes you an Admin inside that product. The button waits a few seconds while your organization is set up inside the product, then takes you right in, so there is no second click. If the setup runs slow it takes you in anyway after about 10 seconds. You also get an email telling you the trial has started.

An owner can open both products whether or not they have a role in either, so an owner cannot lock themselves out. An admin gets a role in the product they turned on, and in nothing else. That is why an admin can be looking at a padlock and `No access` on the other card.

One sign-in covers your account and both products. Inside the PIM or the Repricer, two controls are in the top right corner. One is a grid of squares that brings you back to the product cards. The other is your avatar, whose first menu row opens `My Account`.

### Leave an organization

Everyone except the owner can leave on their own.

In the `My Account` sidebar, under `Organization`, click `Team`, and scroll to the bottom of that page. Under a red heading reading `Danger zone` there is a bordered card called `Leave this organization`, with a `Leave organization` button on its right. Click it, and a dialog opens over the page asking you to confirm.

You lose access to the organization and to every product in it immediately, and an admin has to invite you again to give it back. Nothing you built comes with you.

**The owner cannot leave, and cannot be removed.** An organization has exactly one owner at every moment. An owner who wants out has two ways to get there. The first is to [transfer ownership](/team#giving-the-organization-to-someone-else) to someone else, which makes them the Owner and you an Admin. The second is to delete the organization.

### Delete an organization

<Danger>
  Deleting an organization permanently removes every piece of data attached to it, in both products: the catalog, the integrations, the listings, the team, product access and billing. There is no undo and no restore.
</Danger>

Only the owner can delete one. The `Danger zone` at the bottom of the `General` page is not shown to anyone else, so an admin who cannot find it is not looking in the wrong place.

Inside it is a bordered card called `Delete this organization`, with a `Delete organization` button on its right. Click that button and a dialog called `Delete organization` opens, with a red banner reading `This action is irreversible`.

The dialog asks you to type two things: the organization's name, exactly as it is written, and then the word `DELETE`. The `Delete` button stays gray until both match, and `Cancel` closes the dialog without doing anything.

The subscription is canceled along with the organization, so there is nothing left to close after that. You come back to the product cards, or on the naming screen if that was the only organization you were in.

Deleting an organization is not the same as closing your account. Your account stays exactly as it was. There is no way to delete a personal account from inside Ready for Commerce.

### Limits

| What | Limit |
| --- | --- |
| Characters in the organization name | 100 |
| Owners per organization | 1 |
| Currencies you can choose from | 160 |
| How long an invitation lasts | 7 days |
| How long a free trial lasts | 30 days |
| Organizations you can create or join | No limit |
| Variants that convert while you wait on a currency change | 500 |

### What an organization cannot do

| You cannot | Do this instead |
| --- | --- |
| Merge two organizations | Take what you need out of one with an [export](/pim/uploads/exports) and bring it into the other with an [import](/pim/uploads/imports) |
| Move a group of people from one organization to another | Invite them one address at a time in the new one |
| Have two owners, or none | Transfer ownership, which moves the one seat |
| Give the organization an address of its own | The name is a label, and everyone signs in at the same address |
| Delete your personal account | Leave every organization you are in, and delete the ones you own |
| Change the currency without converting your prices | Set the currency before you build the catalog |
| Give someone access to a product by making them an organization Admin | Give them a role in that product on the `Team` page |

## What the organization owns, and what stays yours

Two things about this split surprise people the first time. Almost everything you would call yours is actually the organization's, and the little that is genuinely yours follows you into every organization you join.

| The organization owns | You own |
| --- | --- |
| The catalog: products, variants, specifications, categories, brands, tags and assets | Your name and the email address you sign in with |
| Every integration connected in either product | The language the apps speak to you in |
| Everything the Repricer prices, and the strategies it prices with | Your timezone, and light or dark |
| Who is on the team, and what each of them can do | Which emails Ready for Commerce sends you |
| The subscription, the plan and the invoices | |
| The currency, and the units new PIM variants start in | |

No one gets a private copy of anything in the left column. Two people in the same organization open the same product and see each other's edits. Nothing in that column comes with you when you leave, and nothing in it changes when you switch to another organization: you are simply looking at a different one.

The right column is covered in [profile and preferences](/profile), and it is the same in every organization you are a member of. Set your language once and it is your language everywhere.

**Your role in the organization and your role inside a product are two separate things.** The roles table above decides what you can do to the business itself. That is renaming it, inviting people, and paying for it. A second role, given to you per product, decides what you can do inside the PIM or the Repricer. Being an Admin of the organization does not by itself open the catalog, and being a Manager in the PIM does not let you see an invoice. The owner is the one exception, and can always open both products. [Team, roles and permissions](/team) sets out both sets of roles in full.

## When something goes wrong

### You are looking at the wrong organization

An empty catalog, a team with one person in it, or an integration you are sure you connected are almost always the same thing. You are in a different organization from the one you meant.

Open the switcher and read the name in it. That name is the organization everything on the screen comes from. Pick the right one and the page reloads against it.

If you are in no organization at all, every page in your account sends you to the screen that creates one. You cannot get past it until you have created one or accepted an invitation.

### A setting will not save

`Error` appears in red at the right edge of the field, and the value you had before comes back on its own. Make the same change again, and reload the page if it fails a second time.

A field you can read but cannot click is not a fault. It means your role is Member, and the whole of `General` shows as plain text for you.

### Messages you might see

| Message | What to do |
| --- | --- |
| `This field can't be empty.` | The organization name cannot be blank. Type something |
| `Use 100 characters or fewer.` | Shorten the name |
| `You do not have permission to perform this action.` | Your role cannot change this. Ask an owner or an admin |
| `We could not save your change. Please try again in a moment.` | Try the same change again |
| `Failed to delete organization` | Nothing was deleted. Reload the page and check the organization is still listed in the switcher |
| `Failed to leave the organization` | Try again, and reload the page if it fails a second time |
| `Couldn't start the trial. Please try again.` | Nothing was turned on. Click `Start free trial` again |
| `This invitation was sent to a different email address.` | Sign in with the address the invitation went to |
| `This invitation is invalid or has expired.` | Ask whoever invited you to send it again |
| `This invitation has already been accepted.` | You are already in. Open the switcher and pick that organization |
| `This user is already a member of the organization.` | The same. Nothing was changed |
| `Something went wrong. Please try again.` | Reload the page and check what happened before trying again |

## Where to go next

<Columns cols={2}>
  <Card title="Team, roles and permissions" icon="users" href="/team">
    Invite people, and decide what each one is allowed to do.
  </Card>

  <Card title="Plans and billing" icon="credit-card" href="/billing">
    What the organization pays for, and who is allowed to see it.
  </Card>

  <Card title="Profile and preferences" icon="user" href="/profile">
    The settings in the other sidebar group, which stay yours.
  </Card>

  <Card title="Connect your first store" icon="plug" href="/connect-a-store">
    The next step once your organization has a currency.
  </Card>
</Columns>
