Skip to main content
Seller onboarding is everything between a seller record being created and that seller being able to trade on your marketplace. Somebody is invited to run the seller account, they accept and sign in to their own panel, they work through a checklist of onboarding tasks that your marketplace sets, and finally your team decides whether to admit them or not. The work is split between the two sides. Your team creates the record, sends the invitation, settles anything that needs a decision from a person, and makes the final call. The seller does the filling in of the details, which is why most of the checklist can only be completed by them. This guide follows that order from beginning to end, so it can be read by your team and handed to a seller as the instructions for their side. Each section says whose work it is and which panel it happens in.
The checklist itself is written once for the whole marketplace under Seller Requirements. This page covers taking one seller through it.

How Onboarding Works

The status is what decides which actions are offered at each point, so a seller who has not been invited cannot be approved, and a seller for which nobody has accepted the invite cannot start the checklist. Creating the record is covered under Sellers. Everything after it is on this page.

How to Invite a Seller

A seller record on its own has nobody attached to it. An invitation is what grants a person access to the seller panel, and sending the first invite is what starts the onboarding process. A new seller, with nothing on the checklist done and Invite in the header
  1. Navigate to Sellers and open the seller.
  2. Click Invite in the header.
  3. Check the email address, which opens with the seller’s contact email already in it. Change it where somebody else is running the seller.
  4. Click Send invitation.
The status becomes Invited, the header button becomes Send again, and the address appears on the Team card as an outstanding invitation. An email goes to that address with a link for joining. An invitation is valid for two weeks by default. Once it has expired, revoke it on the Team card and send a new one in its place. When somebody accepts, the person who sent the invitation receives an email saying so. A seller can have more than one person on its team. The header button sends the first invitation only, and everybody after that is invited from the Team card. See Sellers.
Switching off Email sellers under Marketplace Settings stops the approval, rejection and suspension emails. Invitations are sent either way, because without one nobody can reach the panel at all.

How a Seller Accepts an Invitation

This section and the following one happen in the seller panel rather than in your admin dashboard. The invited person opens the invitation link in their email and fills in a short form:
  • First name
  • Last name
  • Password
  • Password confirmation
Where the address has no account yet, submitting the form creates their sign-in and takes them straight into the seller panel, with no separate log in afterwards. Where it already has one, they enter that account’s existing password instead, and no second account is created. The seller’s status becomes Onboarding. Where the address has no account yet, that link is the whole credential, so anybody holding it can create the account and join the seller’s team. Where it already has one, the link on its own is not enough, because joining also takes that account’s password. Either way the link should go no further than the person it was meant for, and an invitation that has gone astray is stopped with Revoke on the Team card.

Working Through the Checklist

The seller's checklist in their own panel The checklist is under Setup in the seller panel, with the number completed out of the total shown both in the sidebar and at the top of the page. Each requirement is a row that expands to show what is being asked and, in some cases, the control for doing it. None of the tasks depend on each other, so the rows can be worked through in any order. The page opens with the first outstanding task already expanded, so a seller returning to the checklist sees what to do next without reading back through what they have finished. Each row carries a status. The seller’s checklist and your Onboarding card use different wording for the same states, because each is written for its own reader. Some rows are filled in on the checklist itself, and the rest carry a Go there button to wherever in the panel they are satisfied.
  • Accept terms - The terms appear in the row itself, with Accept the terms underneath. If the marketplace publishes them elsewhere as well, Read the terms opens a link to that copy.
  • Complete profile - Opens Settings → Profile, which holds the name, description, logo and cover photo shoppers see. The step lists what is still missing. When you also require a contact email and it is the only thing left, the step opens Settings → General instead.
  • Billing address and Returns address - Filled in on the row itself, so the seller keeps their place on the checklist.
  • Delivery method - Opens Settings → Delivery methods, covered below.
  • Shipping box - Opens Settings → Package types, where the size and weight of the box orders are packed in is recorded. Delivery rates are quoted against that box, so the measurements need to be the real ones.
  • Minimum products - Satisfied by adding the minimum number of Products, covered below.
  • Required custom fields - The fields appear in the row and are saved from there.
  • Seller policy - Opens Settings → Policies. The documents the marketplace asks for are listed at the top of that page under Asked of you, each with a Write it button.
  • Payout account - Hands the seller to the payout provider’s own form, which collects their bank and identity details. Neither reaches your marketplace. See Payouts.
  • Seller confirmation, Manual check and Document - All three are completed in the row itself, and are covered below.
A requirement your marketplace marked as not required shows as Optional and never holds the seller back.

How a Seller Adds a Delivery Method

A delivery method is one way a seller can ship an order, and what that costs the shopper. A physical product with no delivery method behind it quotes no rate at checkout, so the order cannot be completed. An order of digital goods alone skips delivery altogether, so this matters to any seller shipping something physical. A seller adding a delivery method in their own panel The list is under Settings → Delivery methods in the seller panel. It holds the seller’s own methods alongside any the marketplace shares with its sellers, told apart by the Owner column. A shared method cannot be edited by the seller, and a single shared method satisfies this requirement for every seller at once.
  1. Navigate to Settings → Delivery methods.
  2. Click Add delivery method.
  3. Fill in the form.
  4. Click Save.
The form asks for the following:
  • Name - What shoppers read at checkout, such as Standard delivery or Next day.
  • Internal name - A name only the seller sees, for telling two similar methods apart.
  • Show at checkout - On by default. Switching it off keeps the method without offering it to anyone.
  • Kind of goods - The delivery profile this method belongs to, which is what decides the goods it can ship. It opens on the marketplace’s default profile, the right answer for anything posted as an ordinary parcel.
  • Ships to - The delivery zone the method covers. Left blank, the method is offered everywhere that kind of goods reaches.
  • Pricing - How the charge is worked out. It opens on a flat rate, which takes one amount for each currency the marketplace trades in. See Rate calculators for the other ways a rate can be priced.
  • When this method applies - Optional conditions, such as a minimum order value. With none set, the method is offered on every order it is able to ship.
A method is edited or deleted from its own row. Deleting one leaves orders already shipped with it untouched.
Your team can read and edit a seller’s delivery methods under Delivery Profiles, but a new one cannot be created there on a seller’s behalf. To give every seller a way to ship without each of them building one, create a delivery method of your own and switch on Available to sellers.

How a Seller Adds Products

A seller builds a product in their own panel using the same form your team uses, so Adding Products covers the fields themselves. Two things are different. The seller’s form leaves out what belongs to the marketplace rather than to the seller: sales channels, categories, collections, tags and the tax category. Those are filed against the product when it is reviewed. Status is not a field either. The seller saves a product as a draft and then presses Submit for review, which passes it to your team to decide on. See Seller Products for that decision and what happens after it. A seller's products list, with Import and Export above it A seller with a long range does not have to build every product by hand. Import and Export sit above the products list in their panel, exactly as they do on yours, and cover that seller’s own products only. See Import and Export for the file itself and Seller Products for what to watch when a seller exports and reimports. Imported products arrive as drafts, which is where a product built by hand starts too. The seller then selects them in the list and uses the bulk Submit for review action to send the whole batch at once. A product counts towards the Minimum products requirement as soon as it is saved, whether or not it has been submitted or approved. This part of the checklist does not wait on a review.
Switching on Publish seller products automatically under Marketplace Settings approves a seller’s product the moment it is submitted, with nobody reviewing it. Approving is not the same as listing it: the product still reaches shoppers only on a sales channel that carries it, and only while its seller is approved and not on holiday. See Seller Products.

Documents, Confirmations and Manual Checks

These three kinds are the ones your marketplace writes the wording for, and the seller answers each of them on the checklist row rather than anywhere else in the panel. Every one of them gives the seller a note box for anything that should go with their answer.
  • Seller confirmation - The seller reads a statement your marketplace wrote, such as holding the rights to sell what they list, and clicks Confirm.
  • Manual check - The seller clicks Confirm to say they are ready to be checked, and uses the note for whatever reference your marketplace asked them for, such as a tax number.
  • Document - The seller attaches a file, as a PDF, a photo or an office document, and clicks Submit for review.
What happens next is where the three differ. A seller confirmation is taken at the seller’s word, so the row reads Done as soon as they confirm it. A manual check and a document both read In review until somebody on your team accepts them.

What Else a Seller Can Set Up

A seller's profile page, with their business details and tax registrations The checklist is the shortest route to being approved rather than every single detail the seller can manage. Everything below belongs to the seller and can be added or changed at any point, during onboarding or long after it.
  • Stock locations - Under Settings → Stock locations. A seller can hold more than one, which is how a business shipping from two warehouses keeps stock in each. The returns address on the checklist is read from these, taking the default location that accepts returns, so which location holds that mark decides where customers send things back to.
  • Delivery methods - Under Settings → Delivery methods. One is enough to be approved, and more can be added whenever the seller wants to offer another way to ship or charge differently for a region.
  • Package types - Under Settings → Package types. A seller can record several boxes and mark one as the default, which is the box delivery rates are quoted against. The list also carries any packaging your marketplace shares, which a seller can ship with but not change. See Package Types.
  • Policies - Under Settings → Policies. Anything your checklist asks for is listed under Asked of you, and a seller can publish further documents of their own beside them and rewrite any of them later. See Policies.
  • Profile - Under Profile. The name, description, logo and cover photo shoppers see are the seller’s to change at any time. The storefront address is the exception, and only your team can change that.
  • Business details - On the Profile page. The legal name and registration number of the business behind the seller, which is what a commission invoice has to be made out to.
  • Tax registrations - On the Profile page. One registration per tax regime the seller trades under, such as a UK VAT number or a US EIN, and a number can be checked against the registry it belongs to.
No default requirement asks for business details or a tax registration, so a seller fills those in when they have them rather than being held up for them. A marketplace that wants either before admitting anybody collects it with a Manual check, where the seller leaves the number in the note and somebody on your team verifies it. See Seller Requirements.

How a Seller Submits for Review

Submit for review sits at the top of the checklist and stays unavailable while anything required is outstanding, with a count of what is left beside it. Optional rows are ignored by that count. Pressing it moves the seller to Ready for review and passes the decision to your team. The checklist then reports that the marketplace is reviewing the application. No email goes out at this point, so the panel is the only confirmation the seller has until a decision is made.

How to Review What a Seller Submitted

The rest of the onboarding process is managed by your team back in the admin dashboard. A seller's page during onboarding, with a task waiting for review Anything waiting on your team appears on the Onboarding card of the seller’s page, marked Under review, with the seller’s note and a link to download whatever they attached. A policy requirement carries View policy instead, which opens what the seller published.
  1. Navigate to Sellers and open the seller.
  2. Find the row marked Under review and read what the seller sent.
  3. Click Accept to mark the requirement done, or Send back to return it to them.
Accepting moves the seller’s progress forward by one row. Sending it back returns the requirement to the seller, where it reads Needs another look and can be submitted again. Reviewing a single requirement does not change the seller’s own status. A seller who has already submitted stays at Ready for review while a row goes back and forth. To return the whole application to the seller, use Send back to onboarding under More actions, which is covered in Sellers.

How to Waive a Requirement

Waiving excuses one seller from something the marketplace asks of everyone, such as a seller who satisfied it elsewhere or one the requirement was never written for. The row counts as met for that seller alone, and the record shows it was waived rather than done.
  1. On the Onboarding card, open the menu at the end of the row.
  2. Click Waive for this seller.
  3. Confirm.
Any requirement that is switched on can be waived, including the ones worked out from the seller’s own data such as Accept terms or Minimum products. A requirement switched off for the whole marketplace cannot, because it is already asking nothing. A waiver is its own decision rather than an edit of what came before, so anything the seller submitted earlier stays readable on the record. It also cannot be accepted or sent back afterwards.

How to Approve a Seller

Approving is what lets a seller trade. See Sellers for the approval itself, what happens when the checklist is unfinished, and the other decisions available on a seller. Once approved, the seller receives an email saying so unless Email sellers is switched off under Marketplace Settings, and their own panel reports that their products are on sale.
Approving a seller does not put their products on your storefront. Each product still has to be approved and then listed on a sales channel, neither of which the seller can do. See Seller Products.

What the Seller Receives

Three emails can reach a seller during onboarding, and all come from your store rather than from a person on your team.
  • The invitation, sent when Send invitation is clicked, carrying the link that lets somebody join the team.
  • The approval, sent when the seller is approved.
  • The rejection, sent when the seller is turned down.
Submitting the checklist sends nothing, and neither does accepting or sending back a single requirement. Those show up in the seller panel only.

Further Reading