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

# Assigning items

> Link items to a consignor and set the commission you owe on them.

Assigning an item to a consignor tells Supercycle that the consignor owns that stock and earns a share of its revenue. You can assign one item at a time or many at once.

By default, every item you assign to a consignor uses that consignor's **revenue share**. Set once on the [consignor](/documentation/manage/consignment/consignors), it applies to all of their items automatically. If a particular item has different terms, you can override the rate for that item alone.

***

## Assign items to a consignor

<AccordionGroup>
  <Accordion title="From an item">
    <Steps>
      <Step title="Open the item">
        In Shopify admin, go to **Supercycle** > [**Inventory**](https://admin.shopify.com/apps/supercycle/items) and open an item.
      </Step>

      <Step title="Select a consignor">
        In the **Consignor** card, select the edit icon, search for the consignor, and choose **Select**.
      </Step>

      <Step title="Set a commission rate (optional)">
        Enter a **Commission rate** to override the consignor's default for this item. Leave it blank to use the consignor's revenue share. The rate applies to this item's cycles.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="In bulk, from Inventory">
    <Steps>
      <Step title="Select items">
        Go to **Supercycle** > [**Inventory**](https://admin.shopify.com/apps/supercycle/items) and select the items you want to assign.
      </Step>

      <Step title="Assign consignor">
        Open the **•••** menu, choose **Assign consignor**, pick a consignor, and confirm.
      </Step>
    </Steps>

    <Note>
      Reassigning a consignor in bulk clears any per-item commission overrides, so the items fall back to the new consignor's revenue share.
    </Note>
  </Accordion>
</AccordionGroup>

***

## Default rate vs. per-item override

Every item assigned to a consignor **inherits the consignor's revenue share** automatically, so there's nothing to set per item. Change the consignor's rate once on their [page](/documentation/manage/consignment/consignors) and it applies to all of their items.

The **Commission rate** field on an item overrides that default for a single item, for when one item carries different terms:

* Leave it **blank** to use the consignor's revenue share. The field's placeholder shows that default, and help text reads *"Defaults to \[consignor]'s rate of \[x]%. Applies to this item's cycles."*
* Enter a value (0–100%) to use a **different** rate for that item only. It applies to that item's cycles.

<Note>
  Reassigning the item to a different consignor clears any per-item override, so the item falls back to the new consignor's revenue share.
</Note>

***

## How commission is calculated

Commission accrues to a consignor's balance based on what their items actually earn:

<Steps>
  <Step title="A charge is paid">
    When a charge on a consigned item is paid, Supercycle records an **earning** for the consignor.
  </Step>

  <Step title="The rate is applied">
    The earning is the charge's revenue (the **basis**) multiplied by the **commission rate** for that item: the per-item rate if set, otherwise the consignor's revenue share.
  </Step>

  <Step title="The rate is locked in">
    The rate used is saved with the earning. Changing the consignor's revenue share or the item's commission rate later only affects **future** earnings.
  </Step>

  <Step title="Refunds reverse it">
    If that charge is later refunded, Supercycle records a **refund** entry that reduces the consignor's balance by their share of the refunded amount, at the original rate.
  </Step>
</Steps>

Every earning and refund is itemized in the [payout breakdown](/documentation/manage/consignment/payouts#payout-breakdown) when you settle a balance.

<Note>
  Commission is calculated when a charge is **paid**, so an order that's placed but not yet paid doesn't add to a consignor's balance until payment is collected.
</Note>