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

# Return actions

> Step-by-step guides for creating, receiving, and processing returned items

### Create a return

<AccordionGroup>
  <Accordion title="From a Customer request">
    A customer can initiate a return from their rental portal.

    <Steps>
      <Step title="Create return">
        In the rental portal, the customer should click **Return items**. This button may have different text depending on your [Language](/documentation/online-store/languages) settings.
      </Step>

      <Step title="Select items">
        On the next page, the customer can select the items they'd like to return. Then select **Request return**
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="From a Customer">
    You can create a return on behalf of a customer, either proactively or if you receive items back where the customer has not created the return.

    <Steps>
      <Step title="Navigate to customer">
        In Shopify Admin, head to **Supercycle** > [**Customers**](https://admin.shopify.com/apps/supercycle/customers) > **Customer**.
      </Step>

      <Step title="Create new return">
        On the customer page, under **Active rentals** click the **Create return** button.

        <Frame>
          <img src="https://mintcdn.com/supercycle/Omgmq0rsgqX1BZKa/images/screenshots/supercycle-admin/create-return.png?fit=max&auto=format&n=Omgmq0rsgqX1BZKa&q=85&s=7bf98444b9eb16c53ff46773cd22d705" alt="" width="1990" height="1944" data-path="images/screenshots/supercycle-admin/create-return.png" />
        </Frame>
      </Step>

      <Step title="Add items">
        Click **Browse**, Add any items from the list of the customers' active rentals, click **select,** and click **Save**.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="From a Cycle">
    You can create a return directly from a cycle.

    <Steps>
      <Step title="Navigate to rental">
        In Shopify Admin, head to **Supercycle** > [**Rentals**](https://admin.shopify.com/apps/supercycle/rentals) > **Rental**.
      </Step>

      <Step title="Create return">
        On the rental page, click the **Create return** button.
      </Step>

      <Step title="Add items">
        Click **Browse**, add any items from the rental, click **select,** and click **Save**.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="From a Cycle, when items are already back">
    Use this shortcut when the customer has already returned the items physically (for example via their own label or an in-store drop-off) and you just need to record receival. It creates the return and marks the items as received in a single step, and skips the **Return requested** email so the customer isn't asked to send items they've already handed back.

    <Steps>
      <Step title="Navigate to rental">
        In Shopify Admin, head to **Supercycle** > [**Rentals**](https://admin.shopify.com/apps/supercycle/rentals) > **Rental**.
      </Step>

      <Step title="Mark as received">
        On the cycle's inbound card, click the **Mark as received** button next to **Create return**.

        This option only appears on fulfilled cycles that don't already have a return.
      </Step>

      <Step title="Confirm received date">
        Pick the date the items were received and confirm. The return is created and the rentals are marked as received in one action.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Individually or in bulk, via Supercycle Scanner">
    You can create a return by scanning items with the [Supercycle Scanner](/documentation/manage/scanner/scanner).

    <AccordionGroup>
      <Accordion title="Single item">
        <Steps>
          <Step title="Scan a barcode, QR code or RFID tag">
            If the scanned serial number belongs to a rental that doesn't already have an associated return, the rental modal opens automatically.
          </Step>

          <Step title="Create the return">
            Press **Create return & receive** — this creates a return and marks the rental as received in one step.
          </Step>
        </Steps>
      </Accordion>

      <Accordion title="In bulk, from a multi-scan session">
        From a [multi-scan session](/documentation/manage/scanner/scanner#scan-modes), press **Receive return** in the bulk action bar. Any selected item that's on an active cycle gets a return created and is marked received in one step. Items already on a return, or not on a cycle, are skipped. See [Bulk actions](/documentation/manage/scanner/scanner-actions#bulk-actions).
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="Via the MCP">
    Use the [`create_return`](/ai/operators-mcp/tools#returns) tool with:

    * `customer_id` - Customer email or Shopify ID
    * `rental_ids` - Array of rental IDs (e.g. `['SC-1042', 'SC-1043']`)
    * `return_method_type` - Optional: `collection` or `return_label`
  </Accordion>

  <Accordion title="Via the API">
    Use the [Create a return](/api-reference/admin/returnorders/create-a-return) endpoint.
  </Accordion>
</AccordionGroup>

***

### Receive a return

<AccordionGroup>
  <Accordion title="From a Return">
    Click **Receive items** . You can then select which items to be marked as recieved.

    If an item was added to a return by mistake, you can **Edit** the return, removing it to be added to a customer's future returns.
  </Accordion>

  <Accordion title="From a Cycle, without an existing return">
    If the customer has already returned the items physically and no return exists yet, you can record receival directly from the cycle without creating the return first.

    On the cycle's inbound card, click **Mark as received** next to **Create return**, pick the received date, and confirm. Supercycle creates the return and marks the items as received in a single step, and skips the **Return requested** customer email.

    This shortcut is only available on fulfilled cycles that don't yet have a return. Once a return exists, use **From a Return** above (or **Mark as received** from the cycle's inbound card actions menu) instead.
  </Accordion>

  <Accordion title="Individually or in bulk, via Supercycle Scanner">
    Items are automatically marked as received on a return when you create a return from the scanner app. You can also mark items as received manually:

    <AccordionGroup>
      <Accordion title="Per item, from the item detail screen">
        Open a single-scan match and mark the item received from the item detail screen.
      </Accordion>

      <Accordion title="From the return">
        Open the return in the scanner app and mark items received from the returns screen.
      </Accordion>

      <Accordion title="In bulk, from a multi-scan session">
        Scan a batch of items with a Zebra scanner and press **Receive return** in the bulk action bar. Any selected item that's on an active cycle gets a return created and marked received in one step. See [Bulk actions](/documentation/manage/scanner/scanner-actions#bulk-actions).
      </Accordion>
    </AccordionGroup>
  </Accordion>

  <Accordion title="Via the MCP">
    Use the [`update_return`](/ai/operators-mcp/tools#returns) tool with:

    * `id` - Return ID (e.g. `#2001`)
    * `return_lines` - Array of `{ id, status }` where status is `awaiting`, `received`, or `missing`
  </Accordion>

  <Accordion title="Via the API">
    Use the [Update a return](/api-reference/admin/returnorders/update-a-return) endpoint.
  </Accordion>
</AccordionGroup>

***

### Recredit membership items

<AccordionGroup>
  <Accordion title="Automatically on return request">
    You can automatically recredit returns from changing settings in **Supercycle** > **Settings** > <Icon icon="shopify" iconType="solid" /> [Membership rental](https://admin.shopify.com/apps/supercycle/settings/membership).

    <Frame>
      <img src="https://mintcdn.com/supercycle/Omgmq0rsgqX1BZKa/images/screenshots/supercycle-admin/automatically-approve-returns.png?fit=max&auto=format&n=Omgmq0rsgqX1BZKa&q=85&s=790c6524683363279d8182e2a3945cb3" alt="" width="1292" height="600" data-path="images/screenshots/supercycle-admin/automatically-approve-returns.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

***

### Item ready

When an [Item](/documentation/manage/inventory/items) is received from a Return, the processing status is set to `Not Ready` as you’ll typically need to process it (clean, refurbish, etc.) before it’s `Ready` to go out on its next rental.

The process of marking that Item as `Ready` is often called restocking.

<AccordionGroup>
  <Accordion title="From the Item">
    Update processing state from the [Warehouse](/documentation/manage/inventory/items/#warehouse) <Icon icon="circle-2" iconType="solid" color="red" /> field on the Item.
  </Accordion>

  <Accordion title="In bulk, from the Inventory table">
    **Update status** action from the **Actions** <Icon icon="circle-1" iconType="solid" color="red" /> options on the <Icon icon="shopify" iconType="solid" /> [Inventory](https://admin.shopify.com/apps/supercycle/items) table.

    <Frame>
      <img src="https://mintcdn.com/supercycle/XbKBsdX_PulItpyX/images/items/items-inventory-actions.png?fit=max&auto=format&n=XbKBsdX_PulItpyX&q=85&s=d0e9a930cc9c3a0d3a79d0d01692f0f8" alt="" width="3264" height="2178" data-path="images/items/items-inventory-actions.png" />
    </Frame>
  </Accordion>

  <Accordion title="In bulk, from the Cycles table">
    **Update item status** action from the **Actions** <Icon icon="circle-1" iconType="solid" color="red" /> options on the <Icon icon="shopify" iconType="solid" /> [Cycles](https://admin.shopify.com/apps/supercycle/rentals) table.

    <Frame>
      <img src="https://mintcdn.com/supercycle/XbKBsdX_PulItpyX/images/cycles/cycles-actions.png?fit=max&auto=format&n=XbKBsdX_PulItpyX&q=85&s=107f58e8e3643dbe6a4d1f7ee7e9506f" alt="" width="3252" height="2170" data-path="images/cycles/cycles-actions.png" />
    </Frame>
  </Accordion>
</AccordionGroup>
