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

# Consignment overview

> Sell stock owned by brand partners and track the revenue share you owe them.

**Consignment** lets you list and sell stock you don't own. A **consignor** (a brand partner, supplier, or individual) provides items, you rent or resell them, and Supercycle automatically tracks the **revenue share** you owe the consignor as their items earn.

Supercycle keeps a running balance for each consignor, builds it up as their items are paid for, reverses it on refunds, and lets you record payouts to settle up. Consignors can follow along in their own portal.

<Note>
  **Beta feature.** Consignment is currently in beta and is off by default. Access is granted on a per-store basis upon request and approval. Contact support to request access. If you don't see the **Consignment** tab in **Settings**, it isn't enabled for your store yet.
</Note>

***

## How it works

<Steps>
  <Step title="Enable consignment">
    Turn consignment on in **Settings** and choose how you'll pay consignors. See [Enable consignment](#enable-consignment) below.
  </Step>

  <Step title="Add consignors">
    Create a [consignor](/documentation/manage/consignment/consignors) and set their **revenue share** — inherit the shop default, use a percentage, or write a [Liquid formula](/documentation/manage/consignment/revenue-share-formulas).
  </Step>

  <Step title="Assign items">
    [Assign items](/documentation/manage/consignment/assigning-items) to the consignor. Per-item exceptions go through formula context (`item.fields.*`), not a separate rate on the item.
  </Step>

  <Step title="Earn">
    When a charge on a consigned item is paid, Supercycle adds the consignor's share to their **balance owed**. Refunds reverse it automatically.
  </Step>

  <Step title="Pay out">
    Record [payouts](/documentation/manage/consignment/payouts) to settle the balance. Consignors see their balance, activity, and payouts in the [consignor portal](/documentation/manage/consignment/consignor-portal).
  </Step>
</Steps>

***

## Key concepts

| Term              | What it means                                                                                                                                                                             |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Consignor**     | The brand partner or person who owns the stock. Has a name, an optional linked customer, a default revenue share, and payout methods.                                                     |
| **Revenue share** | What the consignor keeps from each paid charge — a shop default, a consignor percentage, or a [Liquid formula](/documentation/manage/consignment/revenue-share-formulas) returning cents. |
| **Shop default**  | The revenue share applied when a consignor inherits. Set under **Settings** > **Consignment**.                                                                                            |
| **Balance owed**  | The money you've accrued for a consignor but haven't yet paid out.                                                                                                                        |
| **Earning**       | An entry added to a consignor's balance when a charge on their item is paid.                                                                                                              |
| **Refund**        | An entry that reverses part of a consignor's balance when a charge is refunded.                                                                                                           |
| **Payout**        | A record of a payment you've made to a consignor, which settles part or all of their balance.                                                                                             |
| **Payout run**    | A batch of payouts recorded together, labelled `Run #1`, `Run #2`, and so on.                                                                                                             |

***

## Payout methods

You choose how you pay consignors in **Settings** > **Consignment**.

| Method            | Status      | Description                                                                         |
| ----------------- | ----------- | ----------------------------------------------------------------------------------- |
| **Manual**        | Active      | Record payouts you make outside Supercycle, like cash or a transfer from your bank. |
| **Store credit**  | Coming soon | Pay consignors with credit to spend in your store.                                  |
| **Bank transfer** | Coming soon | Send payouts directly to consignor bank accounts.                                   |

Recording a payout in Supercycle tracks what you owe and what you've paid. It doesn't move any money itself. With the **Manual** method you make the actual payment outside Supercycle.

***

## Consignment and your other methods

Consignment is independent of how an item is sold. An item can be on resale, on a rental method, or both. Assigning it to a consignor simply changes who earns a share of the revenue when it's paid for.

* Store-owned items have no consignor and earn you 100% of the revenue.
* Consigned items earn the consignor their revenue share, and you keep the rest.

This means you can run consigned and store-owned stock side by side, and a single order can include both.

***

## Enable consignment

<Steps>
  <Step title="Open consignment settings">
    In Shopify admin, go to **Supercycle** > **Settings** > <Icon icon="shopify" iconType="solid" /> [**Consignment**](https://admin.shopify.com/apps/supercycle/settings/consignment).
  </Step>

  <Step title="Enable consignment">
    Turn on **Enable consignment**, then **Save**. Once saved, **Manage consignors** becomes available.
  </Step>

  <Step title="Review payout methods">
    Under **Payout methods**, **Manual** is active by default: record payouts you make outside Supercycle, like cash or a bank transfer. **Store credit** and **Bank transfer** are coming soon.
  </Step>

  <Step title="Set the default revenue share">
    Under **Default revenue share**, choose **Percentage of sale** or **Formula**. This applies to every consignor that inherits the shop default. See [Revenue share formulas](/documentation/manage/consignment/revenue-share-formulas) for formula syntax and examples.
  </Step>
</Steps>

<Note>
  Consignment is rolling out gradually. If you don't see the **Consignment** tab in settings, it isn't enabled for your store yet, so contact support to request access.
</Note>

***

## Consignment FAQs

<AccordionGroup>
  <Accordion title="When does a consignor start earning?">
    A consignor earns when a charge on one of their items is **paid**, not when the order is placed. Supercycle renders the revenue share formula at that moment and freezes the amount on the ledger entry.
  </Accordion>

  <Accordion title="What happens on a refund?">
    If a paid charge is later refunded, Supercycle adds a reversing **refund** entry proportional to the original earning — the refunded share of the basis reverses the same share of the amount. The formula is not re-rendered.
  </Accordion>

  <Accordion title="What happens if I change a consignor's revenue share later?">
    The formula and amount are frozen when each earning is recorded. Changing a consignor's revenue share or the shop default only affects future earnings. Past ledger entries are not recalculated.
  </Accordion>

  <Accordion title="Does recording a payout send money to the consignor?">
    No. Supercycle records what you owe and what you've paid. With the **Manual** method you make the actual payment yourself, then record it to settle the balance.
  </Accordion>
</AccordionGroup>
