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

# Sellers

> Learn how to add the third-party sellers trading on your marketplace, review where each one stands, and approve or suspend them.

A seller is a third-party business trading on your marketplace. Each one lists its own products, fulfills its own orders and is paid for what it sells, less the commission you charge.

Every seller has a record holding everything about that business in one place: the people who run it, how much of your onboarding checklist it has completed, its contact and address details, and what it has earned and is owed. The sellers list gathers those records onto one screen, so every seller and its current state can be seen together.

Sellers maintain their own profile, catalog and orders from their own panel, so most of the work on this screen is deciding who may trade, correcting details on a seller's behalf, and setting the commercial terms that only the marketplace operator controls.

To manage sellers, navigate to **Sellers** in the admin dashboard.

## Reviewing Your Sellers

![The Sellers list, showing each seller's status and onboarding progress](https://mintcdn.com/spreecommerce/MGeCfF6jUlQF-PTO/images/user/sellers/sellers/1-sellers-list.png?fit=max\&auto=format\&n=MGeCfF6jUlQF-PTO\&q=85\&s=53b3bb61cc96e7801045815ff0d1dac2)

The list shows one row per seller.

| Column | What it means |
| - | - |
| **Name** | What the business is called. |
| **Status** | Where the seller stands with you, described below. |
| **Contact email** | Where marketplace notices are sent, and the address an invitation is offered to by default. |
| **Onboarding** | How much of your checklist they have completed, such as 3 of 7 done. |
| **Products** | How many products the seller has, drafts and products in review included. |
| **Team** | How many people can sign in and run the seller. |
| **Created at** | When the seller record was added. |

Which columns appear is yours to choose, so a marketplace that never looks at team size can hide that column and keep the list to what it reads every day. Filtering by **Status** is the quickest way to bring up everyone waiting on a decision from you.

### Seller Statuses

A status indicates the point a seller has reached between being created and trading. The status is never typed in or updated manually. It changes in response to what you and the seller each do, and it governs what the seller can do next as well as which actions are offered to you on their page.

| Status | What it means |
| - | - |
| **Pending** | The record exists, but nobody has been invited to run it yet. |
| **Invited** | An invitation has been sent and nobody has accepted it. |
| **Canceled** | The seller withdrew before joining. |
| **Onboarding** | Somebody has accepted the invitation and is working through the checklist. |
| **Ready for review** | The checklist is finished and the seller is waiting on your decision. |
| **Approved** | The seller can trade on your marketplace. |
| **Rejected** | The seller was turned down and cannot trade. |
| **Suspended** | An approved seller has been stopped from trading, and can be reinstated later. |

## How to Add a Seller

Adding a seller creates the record. Inviting the people who will run it, and approving them, both happen afterwards from the seller's own page.

1. Click **Add seller**.
2. Enter the business's **Name**.
3. Enter a **Contact email**, which is where marketplace notices are sent.
4. Click **Create seller**.

The seller's page opens, with the status **Pending** and nothing on the checklist done.

> [!NOTE]
>
> The contact email is not an invitation. Nobody can sign in to the seller account until somebody has been invited and has accepted, which is covered in [Onboarding](https://spreecommerce.org/docs/user/sellers/onboarding.md).

## Reading a Seller's Page

![A seller's page, with its onboarding checklist and status](https://mintcdn.com/spreecommerce/w-PMwn1fLOetuN6Q/images/user/sellers/sellers/2-seller-page.png?fit=max\&auto=format\&n=w-PMwn1fLOetuN6Q\&q=85\&s=bfd376c556b3083d44e03d2c45db37d5)

The header shows the seller's name, its status, how much of the checklist has been completed, and the main action available at that point, which is **Invite** before the seller has accepted and **Approve** once they are ready for review. The rest of the seller data sits on cards below.

* **Profile** - The cover photo, logo, name, storefront address and public description, which together are what a shopper sees.
* **Onboarding** - Every requirement on your checklist with the state of each one, and a link to **Manage requirements**, which opens the checklist itself. See [Seller Requirements](https://spreecommerce.org/docs/user/settings/seller-requirements.md).
* **Team** - The people who can sign in and run this seller, and any invitations still outstanding.
* **Status** - The current status with a sentence explaining it.
* **At a glance** - How many products and team members the seller has, and when the record was created.
* **Balance** - What the seller has earned, been paid and is owed. This card appears only once the seller has earned something. See [Payouts](https://spreecommerce.org/docs/user/sellers/payouts.md).
* **Contact** - The contact email and the billing email.
* **Billing address** - Where the seller is invoiced for commission.
* **Returns address** - Where customer returns are sent.
* **Payouts and tax** - Who remits tax, and this seller's own payout schedule and minimum payout where they differ from your marketplace defaults.
* **Custom fields** - Any extra fields your marketplace records against sellers. See [Custom Fields](https://spreecommerce.org/docs/user/settings/custom-fields.md).

Cards are not hidden when the seller has not filled them in yet. A card with no data simply shows blank fields, so you can see at a glance where a seller has got to without opening their checklist.

## Editing a Seller's Details

Almost everything on a seller's record belongs to the seller, who maintains it from their own panel. The same fields can be edited here on their behalf, which is what you need when a seller cannot correct something themselves, such as before anyone has accepted the invitation.

Two things work differently. The payout and tax settings are yours alone, and the seller never sees them. The returns address is the seller's alone, and can be read here but changed only by them.

### Seller Profile

The edit button on the profile card, and the one on the **Contact** card, both open the same panel:

* **Logo** - Shown beside the seller wherever they appear. A square image works best.
* **Square logo** - Used where a tight square is needed, such as an avatar.
* **Cover photo** - The wide banner across the top of the seller's profile.
* **Name** - What the business is called.
* **Slug** - The seller's address on your storefront.
* **Contact email** - Where marketplace notices are sent, and the address an invitation is offered to by default.
* **Billing email** - Where commission invoices are sent, when that differs from the contact email.
* **About** - The public description shown on the seller's profile.

The seller maintains all of these from their own panel except the slug, which only the marketplace operator can change. A seller renaming their own storefront address would break every link already pointing at it.

### Payouts and Tax

These are set from the **Payouts and tax** card and are not shown to the seller:

* **Tax remittance** - Whether the seller or the marketplace remits consumer tax on that seller's sales.
* **Payout schedule** - How often this seller is paid, or **Use store default** to follow your marketplace setting.
* **Minimum payout** - How much has to build up before this seller is paid.
* **Holiday mode until** - A date the seller is away until. Their products stay visible on your storefront but cannot be bought until that date passes, so the seller keeps their listings and their search ranking instead of taking everything down and putting it back.

The defaults these fall back on are under [Marketplace Settings](https://spreecommerce.org/docs/user/settings/marketplace.md). Setting a value here applies to this seller only.

### Addresses

The **Billing address** is edited from its own card, and is the address a commission invoice is made out to.

The **Returns address** is read-only on this screen. It comes from the seller's default stock location, so it changes when the seller changes the address on that location in their own panel.

### Custom Fields

![A seller's Custom fields card](https://mintcdn.com/spreecommerce/w-PMwn1fLOetuN6Q/images/user/sellers/sellers/3-custom-fields.png?fit=max\&auto=format\&n=w-PMwn1fLOetuN6Q\&q=85\&s=f407a02c877cae14efb686119deb129e)

Any custom fields your marketplace records against sellers are shown and edited on the **Custom fields** card. A field the seller was asked to fill in on their checklist shows their answer here, which is where you read what they told you, and a field only your own team uses is filled in here. See [Custom Fields](https://spreecommerce.org/docs/user/settings/custom-fields.md) for creating the fields themselves, and [Seller Requirements](https://spreecommerce.org/docs/user/settings/seller-requirements.md) for asking a seller to complete one.

### Team

The **Team** card lists everyone who can sign in and run this seller, together with invitations that have been sent and not yet accepted. Four things can be done from it:

* **Invite** adds somebody to the seller's team. They join when they accept.
* **Resend** sends an outstanding invitation again.
* **Revoke** stops an outstanding invitation working.
* **Remove** takes a team member's access to the seller away.

Inviting the first person is what starts a seller's onboarding, which is covered in [Onboarding](https://spreecommerce.org/docs/user/sellers/onboarding.md).

### What Cannot Be Edited Directly

A seller's **status** is never typed in or picked from a list. It moves only through the actions below, each of which sends the right notification, provisions what the new status needs and records who decided it.

**Products cannot be created for a seller.** A product belongs to whoever submitted it, and there is no way to add one on a seller's behalf or to move one of your own products over to them. Reviewing, approving and listing what a seller submits is the extent of it. See [Seller Products](https://spreecommerce.org/docs/user/sellers/products.md).

**A payout account cannot be swapped by you.** Where your marketplace pays through Stripe Connect, the account a seller is paid into is the one that seller connected, and a seller who needs to be paid somewhere else has to connect the new account themselves. See [Payouts](https://spreecommerce.org/docs/user/sellers/payouts.md).

**Delivery methods cannot be added for a seller.** The methods a seller has set up can be read and edited under [Delivery Profiles](https://spreecommerce.org/docs/user/settings/delivery-profiles.md), but a new one cannot be created on their behalf. A seller needing another way to ship adds it from their own panel. The alternative is a delivery method of your own shared with sellers, which reaches every seller at once rather than one.

## How to Approve a Seller

Approving lets a seller trade. The **Approve** button appears in the header once somebody has accepted an invitation and the seller is working through the checklist.

1. Open the seller and read the **Onboarding** card.
2. Settle anything waiting on you, such as a document to read or a manual check to mark done.
3. Click **Approve**.

A seller who has finished the checklist is approved straight away. A seller who has not finished brings up a confirmation naming the requirements still outstanding, and approving from there admits them regardless. The decision is recorded along with what was outstanding at the time.

![The confirmation shown when approving a seller whose checklist is unfinished](https://mintcdn.com/spreecommerce/w-PMwn1fLOetuN6Q/images/user/sellers/sellers/4-approve-anyway.png?fit=max\&auto=format\&n=w-PMwn1fLOetuN6Q\&q=85\&s=5472cddd85dff932876c7bc2103d7928)

> [!NOTE]
>
> Where **Approve sellers automatically** is switched on under [Marketplace Settings](https://spreecommerce.org/docs/user/settings/marketplace.md), a seller is approved as soon as they submit a finished checklist for review, and never waits on you.

## How to Reject or Send Back a Seller

![The More actions menu on a seller's page](https://mintcdn.com/spreecommerce/w-PMwn1fLOetuN6Q/images/user/sellers/sellers/5-more-actions.png?fit=max\&auto=format\&n=w-PMwn1fLOetuN6Q\&q=85\&s=da02bd67372b56f2badc13e1381d9095)

Both decisions are made from **More actions** on the seller's page, and both apply before a seller has been approved.

**Reject** turns down an applicant. The seller is not admitted and cannot trade. A rejection is not final, because the **Approve** button is still offered on a rejected seller if the decision needs reversing.

**Send back to onboarding** is offered on a seller who is waiting for review. It returns them to the checklist so they can correct their details and ask for review again, rather than deciding either way.

## How to Suspend or Reinstate a Seller

**Suspend** is found under **More actions** on an approved seller. Suspending stops them selling immediately while keeping their catalog, their order history and everything they have earned, so money already owed can still be settled.

A suspended seller is reinstated with the **Reinstate** button in the header, which returns them to approved and lets them trade again.

## How to Delete a Seller

**Delete seller** removes the record entirely and cannot be undone. Products the seller listed stay in your catalog without a seller attached.

> [!WARNING]
>
> Deleting is not the way to stop a seller trading. Suspending keeps the record, its orders and its earnings, which is what lets you settle what is already owed and reinstate the seller later. Delete only a record that should never have existed.

## Further Reading

* [Onboarding](https://spreecommerce.org/docs/user/sellers/onboarding.md) - Inviting a seller and getting them through the checklist
* [Seller Requirements](https://spreecommerce.org/docs/user/settings/seller-requirements.md) - The checklist itself
* [The Seller Panel](https://spreecommerce.org/docs/user/sellers/seller-panel.md) - What a seller sees and does on their side
* [Marketplace Settings](https://spreecommerce.org/docs/user/settings/marketplace.md) - Payouts, admission and commission tax
* [Payouts](https://spreecommerce.org/docs/user/sellers/payouts.md) - Settling what a seller is owed


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.