Skip to main content
Everything you do to an item once it exists, from creating it to taking it out of circulation.

​
Create items

Create inventory against the product in Supercycle, not against the Shopify product, since Supercycle owns inventory management once a product is imported.
1

Open the product

On Products, select the product you’re adding items to.
2

Select Add inventory

On the Inventory card, select Add inventory.
3

Pick the variant

Set Variant to the variant the new items belong to.
4

Enter the serials

Leave Add with serials selected and enter one serial per line, one line per item.To create items without serials, select Add without serials and enter a quantity. You can add serials to those items later from their item page.
5

Review and add

Select Review, check the items you’re about to create, then select Add inventory.

Select Add inventory, enter a serial per line, then Review and Add inventory.

1

Scan an unknown tag

Scan a barcode, QR code, or RFID tag. If the serial number doesn’t exist in Supercycle yet, the Create item screen opens.
2

Select the product

Tap Select a product to load the product list, then scroll or search to the product and variant the item belongs to.
3

Set the status

Confirm the item’s visibility: Active, Draft, Retired, or Sold.
4

Tap Create item

Tap Create item. The Scanner opens the new item’s page, where you can set details such as the pick location.
5

Create several items at once (optional)

In a multi-scan session with a Zebra scanner, unknown serials show as Unknown tag rows. Tap Create item in the bulk action bar, pick one product and status for the batch, and tap Create items. The rows flip from Unknown to Matched and become eligible for the other bulk actions.

​
Create serials

A serial is the unique code on the tag attached to one item. Either generate your own codes and program them onto tags, or buy pre-coded tags and assign their IDs to items in Supercycle.
1

Open the item

On Inventory, select the item you’re serializing.
2

Edit the serial number

On the Serial number card, select the edit icon and enter the code from the item’s tag.
3

Save

Select Save in the save bar. The card shows the serial and its barcode.
To set serials as you create items, enter one per line under Add with serials. See Create items.
Scanning a tag whose serial Supercycle doesn’t know opens the Create item screen, and the new item is created with that serial. See Create items.

​
Update item condition

1

Open the item

On Inventory, select the item.
2

Set the condition

Set Condition to the item’s new grade, then select Save in the save bar.
Use the Update item action in a workflow. Pass rental.item.id from a cycle trigger and the target condition’s GID as conditionId. Update item condition after first cycle is a worked example.

​
Update item processing status

An item’s processing status is Ready or Not ready. Supercycle sets it to Not ready when the item comes back from a cycle, so set it back once the item has been processed.
1

Open the item

On Inventory, select the item.
2

Set the status

Set Status to Ready or Not ready, then select Save in the save bar.

​
Update item warehouse location

1

Open the item

On Inventory, select the item.
2

Set the location

Set Location to the warehouse or store the item now lives at, then select Save in the save bar.
1

Scan the item

Scan the item’s barcode, QR code, or RFID tag to open the item screen.
2

Tap the warehouse row

Tap the warehouse row to open the warehouse picker and choose the destination.
3

Tap Save changes

Tap Save changes. The item moves to the new warehouse.
4

Move several items at once (optional)

In a multi-scan session with a Zebra scanner, tap Warehouse in the bulk action bar, pick the destination, and tap Apply. Every selected item is moved in one call. See Bulk actions.

​
Update item tags

1

Open the item

On Inventory, select the item.
2

Edit the tags

On the Tags card, enter a tag to add it, or remove one you no longer need.
3

Save

Select Save in the save bar. Tags are searchable from the Inventory table.
Use the add_tag or remove_tag tool with:
  • resource_type: item
  • resource_id: the item ID, for example #1042
  • tag: the tag to add or remove
Use the Update an item endpoint with the tagsAttributes parameter.

​
Update item product

Reassign items to a different variant when they’ve been tagged against the wrong product, when a product has been split or merged in Shopify, or when you’re consolidating items under one canonical variant. You only pick the variant. The product link is derived from it, and the affected products are re-ingested so their availability and inventory counts stay in step.
1

Open the item

On Inventory, select the item.
2

Change the variant

On the Product card, pick the new variant, then select Save in the save bar.

​
Update blocked dates

Blocked dates take items, variants, or products out of availability for a period. You can change the From and To sides of those ranges in bulk.
1

Select the blocks

On Blocked dates, tick the rows you want to change.
2

Choose Update blocked dates

Select Actions, then Update blocked dates.
3

Set the new dates

Set a new From date, a new To date, or both. A value overwrites that side on every selected row, and an empty field clears that side on every selected row. Each side applies on its own, so you can change one without touching the other.
4

Save

Save to apply the change to every selected row.
Blocks created by a cycle are managed from that cycle and are skipped by this action.

​
Make item unavailable

When something is wrong with an item and you need to stop new cycles being booked on it for a while, set its visibility to Draft. To take it out of circulation for good, retire the item instead.
Making an item unavailable doesn’t remove the cycles already booked on it. Go through those cycles and reassign them where you need to.
1

Open the item

On Inventory, select the item.
2

Set visibility to Draft

Set Visibility to Draft.
3

Save

Select Save in the save bar. The badge next to the item number changes to Draft.

Set Visibility to Draft, then Save.

1

Scan the item

Scan the item’s barcode, QR code, or RFID tag to open the item screen.
2

Pick the new status

Tap the status dropdown and pick Active, Draft, Retired, or Sold.
3

Update several items at once (optional)

In a multi-scan session with a Zebra scanner, tap Visibility in the bulk action bar, pick the status, and tap Apply. Every selected item is updated in one call. See Bulk actions.

​
Retire item

Retiring an item stops new cycles being booked on it while keeping its history. Retiring can be reversed, so to pull an item out of circulation temporarily, make it unavailable instead.
1

Open the item

On Inventory, select the item.
2

Set visibility to Retired

Set Visibility to Retired.
3

Save

Select Save in the save bar. The badge next to the item number changes to Retired.

Set Visibility to Retired, then Save.

1

Scan the item

Scan the item’s barcode, QR code, or RFID tag to open the item screen.
2

Pick the new status

Tap the status dropdown and pick Active, Draft, Retired, or Sold.
3

Update several items at once (optional)

In a multi-scan session with a Zebra scanner, tap Visibility in the bulk action bar, pick the status, and tap Apply. Every selected item is updated in one call. See Bulk actions.

​
Delete items

An item can only be deleted while it has no cycles on record. Use deletion sparingly, for an item created by mistake, since it permanently removes everything about that unit, including its share of stock utilization analytics.
Deleting an item can’t be undone. Retire the item instead when it has completed cycles you want to keep.
1

Select the items

On Inventory, tick the items you’re deleting.
2

Choose Delete items

Select Actions, then Delete items, and confirm.
3

Check what was kept

Bulk delete removes only the items with no cycles and skips the rest, and the toast says so: 46 items deleted, 4 kept because they have cycles. Retire them instead. When every selected item can go, the toast is a plain count such as 2 items deleted.

Tick the items, then open Actions to reach Delete items.

Deleting one item from its own page is blocked the same way. Supercycle shows Item #1042 can’t be deleted because it has cycles. Retire the item instead.