> ## 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 so they earn a revenue share when the item is sold.

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.

Every item uses its consignor's [revenue share](/documentation/manage/consignment/revenue-share-formulas) — inherit, percentage, or formula. There is no per-item rate override. To treat one item differently, add a custom field on the item and reference it in the formula (for example `item.fields.payout_rate`).

***

## 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>
    </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>
  </Accordion>
</AccordionGroup>

***

## How revenue share is calculated

Revenue share 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 formula renders">
    Supercycle resolves the consignor's revenue share (or the shop default when they inherit), renders the formula against the charge, cycle, item, and consignor, and records the result in cents.
  </Step>

  <Step title="The amount is frozen">
    The formula text, basis, amount, and source are saved with the earning. Changing settings later only affects **future** earnings.
  </Step>

  <Step title="Refunds reverse proportionally">
    If that charge is later refunded, Supercycle records a **refund** entry that reverses the same proportion of the original amount — the formula is not re-rendered.
  </Step>
</Steps>

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

<Note>
  Revenue share 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>