Sellers

Overview

Your marketplace can have multiple sellers who list and sell their own products or services. This page covers how to configure the seller experience, from onboarding to payouts.

Seller Onboarding Flow

When someone wants to sell on your marketplace, they go through this process:

Seller Approval Settings

Choose how new sellers are approved to sell on your marketplace:

Listing Moderation

Control how new listings from sellers are published:

Listing Statuses

Restricting Links in Listings

By default, sellers can add links inside a listing's description. If you'd rather keep buyers on your marketplace - and stop sellers from pointing them to their own website, Etsy, or other stores - turn on Don't Allow Links in Listings under Store Settings → Sellers & Buyers → Seller Approval.

When this setting is on:

• The "Add link" button is removed from the listing description editor, so sellers can't insert clickable links.
• On save, the listing title and description are also checked for typed-out web addresses (for example www.myshop.com or myshop.etsy.com). If one is found, the listing isn't saved and the seller is asked to remove it - so the rule can't be worked around by pasting a URL as plain text.
• The message sellers see is shown in your marketplace's language.

Seller Dashboard

Once approved, sellers access their dashboard to manage their business:

How Sellers Create Listings

Sellers create listings from their dashboard using the form you've configured. The fields they see depend on your Listing Form settings.

As the marketplace owner, you can also duplicate any listing straight from the Store Settings → Listings tab. You land on the copy's edit form with a “Listing duplicated - review title + URL, then save” banner and an editable Listing URL field, pre-filled with a clean slug. You can set the public link once here: it's checked for uniqueness in your store (you'll see “URL already taken” if it clashes) and then locked on the first save, so shared links stay stable afterwards. Duplicated URLs no longer carry a “copy” fragment - only the title keeps the “(Copy)” marker so you can tell duplicates apart in the dashboard.

Commission & Payments

When a sale is made, the payment is automatically split between you and the seller:

How Payouts Work

• Automatic splits: Stripe Connect handles the payment split automatically
• Direct deposits: Sellers receive payouts directly to their bank account
• Your earnings: Commission is deposited to your Stripe account
• Payout timing: Follows Stripe's standard schedule — a new account's first payout is held ~7-14 days for review, then payouts arrive on a rolling basis (about 2 business days in the US). Managed by Stripe, not set in Prometora.

Seller Profiles

Public seller profiles build trust and let buyers browse a seller's listings, reviews, and story — each seller's personalized storefront. Profile pages have their own docs page covering visible sections and their order, custom profile URLs (vanity slugs), buyer-visible profile fields, and search-engine indexing.

Custom Signup & Seller Fields

You can define your own fields on the seller signup form (and on the seller dashboard) to collect any information you need — KYC details, payout info, niche eligibility, internal notes, anything. Each field has three configuration dials that decide where it's captured, who can see it, and whether it gates the seller's ability to publish.

Common patterns:

• Internal score — admin-only, captured at signup, used to rank or filter sellers in the admin table
• Vetted niche category — admin-only with approval gate, so sellers can't go live until you confirm they fit your marketplace
• Display tagline — visible to seller, captured on first listing, surfaces on their public profile
• VAT / tax ID — visible at signup, required for European stores

Buyer & Seller Terminology

The default "Buyer" and "Seller" labels don't fit every marketplace. A coaching marketplace might prefer Athlete and Coach; a rental marketplace might prefer Guest and Host. Set custom labels in Store Settings → Buyer & Seller and they replace the defaults across the public storefront.

Leave any field blank to keep the default translated label. The override only applies on surfaces where the role label is rendered as plain text — places like email subjects, system pages, and admin tools still use the default terminology.

Managing Sellers as Admin

As the marketplace owner, you can manage all sellers from your admin dashboard:

• View all sellers: See list of all sellers with their status
• Approve/reject applications: Review pending seller requests
• Suspend sellers: Temporarily disable a seller's account
• View seller listings: See all listings from a specific seller
• Moderate listings: Approve, reject, or unpublish listings

Reference IDs

Every seller and every listing has a short reference ID (for example #7CE66C3), shown as a small badge next to the name. You'll see it in Seller Management, the seller detail view, and Seller Listings, and each seller also sees it on their own dashboard and listings. Click a badge to copy the full ID to your clipboard.

Reference IDs are only shown to sellers and marketplace owners. They never appear on buyer-facing pages such as public listings, storefront cards, or the checkout.

• Search by ID: The search box on Seller Management and Seller Listings matches the reference ID, so you can jump straight to a specific seller or listing.
• Short vs. full: The badge shows a short code for readability; clicking copies the full ID, which is what you'll want when looking a record up directly.
• Stable: An ID never changes, so it's a reliable way to refer to a seller or listing in a support or complaint case.

"Become a Seller" Button

Buyers can upgrade to seller status using the "Become a Seller" button in the navigation. The button respects your approval settings:

• Auto-approve off: Buyer is immediately upgraded to an active seller
• Manual approval on: Buyer sees a pending state and must wait for admin approval before creating listings

Buyer Management

The Sellers & Buyers tab in Store Settings includes a Buyer Management section where you can search, filter, and manage buyers on your marketplace.

Features

• Search buyers: Find buyers by name or email
• Filter by status: View all, active, or banned buyers
• Stats overview: See total, active, and banned buyer counts at a glance
• Ban/unban buyers: Restrict or restore buyer access with a single click

Buyer Banning

When you ban a buyer, you can select a reason from predefined options (fraudulent activity, repeated chargebacks, abusive behavior, policy violation, spam, or custom reason). The banned buyer:

• Receives an email notification explaining they've been restricted (with the reason if provided)
• Cannot sign in to the marketplace (blocked on all auth methods: password, magic link, social login)
• Can be unbanned at any time, restoring full access