> ## 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. # Item actions > Step-by-step guides for creating, updating, retiring, and managing inventory items ### Create items You should create inventory inside your Supercycle product, not your Shopify product, as Supercycle is responsible for inventory management after import. In Shopify Admin, head to **Supercycle** > [**Products**](https://admin.shopify.com/apps/supercycle/products/) > **Product**.

In the variants table, under the status you want to add a product, select the current quantity dropdown followed by **Add inventory**.

On the next page, add a serial number on a new line for each item you'd like to create. Alternatively, select **Add without serials** and enter a number of items. You can add serials to the newly created items later from their item page.

Click **Review** to continue. Review the items you're about to add and click **Add inventory** to save your changes.

Always use the provided template (Sample CSV). Exports often contain extra columns that imports ignore. Download example CSV

Every row represents one item. Include these columns:

Column	Purpose
Item	Unique ID for the item (for example, #2001). New ID = new item. Existing ID = update that item.
Variant Shopify ID	Links the item to its Shopify product variant.
SKU	Stock keeping unit. Recommended even if Variant ID is included.
Visibility	Sets whether the item is `available` or `unavailable`.
Status	Workflow state, such as `processed`, `unprocessed`, or `retired`.

Optional columns include Condition. Mandatory fields for the import

Use a **new Item ID** or **Serial number** and provide the correct Variant Shopify ID and SKU.\ Example: Example CSV row for new items

Keep the **same Item ID** but change values like condition, visibility, or status.\ Example: Example CSV row for updating existing items

The importer cannot delete items. To remove an item from circulation, set:

Visibility = unavailable
Status = retired

Example:

Import the completed CSV into Supercycle. Changes are applied immediately, and the store owner receives an email report showing how many items were added, how many were updated, and any failures. ## Common mistakes * Leaving **Variant Shopify ID** and **SKU** blank → item cannot be linked. * Reusing an **Item ID** for a new unit → overwrites instead of creating. You can create a new item by scanning a serial number with the [Supercycle Scanner](/documentation/manage/scanner/scanner). If the scanned serial number doesn't already exist in Supercycle, the **Create item** modal opens automatically. Press **Select a product** to load the full product list. Scroll or search to find the product and variant for the item you've scanned. Confirm the status for the new item (`Active`, `Draft`, `Retired`, `Sold`). Press **Create item** to finish adding the new item to your inventory. After the item is created, Supercycle opens the item details page. From there, you can review and update additional info, such as the pick location. When you're in a [multi-scan session](/documentation/manage/scanner/scanner#scan-modes) with a Zebra scanner, any unknown serials show as **Unknown tag** rows. You can turn them into items in one step: The count next to **Create item** shows how many unknown serials will be created. The same product and status applies to every serial in the batch. The serials are listed read-only so you can confirm what you're creating. Press **Create items** to create them in one call. The multi-scan list automatically re-resolves the serials, so the rows flip from **Unknown** to **Matched** and become eligible for the other bulk actions. *** ### Make item unavailable If there’s something wrong with an item and you need to stop future rentals from being placed on it temporarily, you can make it unavailable. Making an item unavailable won't remove its existing future rentals. You should go through its existing rentals and reassign them if necessary. Make item unavailable by changing the **Visibility** status to **Draft**.

Change an item's visibility status — `Active`, `Draft`, `Retired`, or `Sold` — from the scanner. From the item detail screen, tap the status dropdown and pick the new status. From a [multi-scan session](/documentation/manage/scanner/scanner#scan-modes), press **Visibility** in the bulk action bar, pick the status, and apply — every selected item is updated in one call. See [Bulk actions](/documentation/manage/scanner/scanner-actions#bulk-actions). If you need to make an item permanently unavailable, you should [retire the item](documentation/manage/inventory/items#retire-items). *** ### Update blocked dates Blocked dates take items, variants, or products out of availability for a specific period. You can change the **From** and **To** sides of those date ranges in bulk from the Blocked dates table. On the [Blocked dates](https://admin.shopify.com/apps/supercycle/unavailabilities) table, select the rows you want to change, then choose **Update blocked dates** from the **Actions** menu. In the modal, set a new **From** date, a new **To** date, or both: * **Set a value** to overwrite that side on every selected row. * **Leave a field empty** to clear that side on every selected row. * **Leave both fields empty** to clear both sides. Each side is applied independently, so you can update one side without affecting the other. Rental-typed blocked dates are managed from the rental and are skipped by this action. *** ### Delete items If an item has no previous rentals on it, you can delete it. We recommend only using this for items created accidentally, as all of the item’s data will be permanently deleted (affecting analytics on stock utilization). **Delete items** action from the **Actions** options on the [Inventory](https://admin.shopify.com/apps/supercycle/items) table.

*** ### Retire item Retiring an item will prevent future rentals from being placed against it. Retiring can be reversed, although if you intend to remove an item from circulation temporarily we recommend making it unavailable instead. Retire item from the [Visibility](#visibility) field. Change an item's visibility status — `Active`, `Draft`, `Retired`, or `Sold` — from the scanner. From the item detail screen, tap the status dropdown and pick the new status. From a [multi-scan session](/documentation/manage/scanner/scanner#scan-modes), press **Visibility** in the bulk action bar, pick the status, and apply — every selected item is updated in one call. See [Bulk actions](/documentation/manage/scanner/scanner-actions#bulk-actions). *** ### Update item condition Update condition from the [Condition](#condition) field. **Update condition** action from the **Actions** options on the [Inventory](https://admin.shopify.com/apps/supercycle/items) table.

**Update item condition** action from the **Actions** options on the [Cycles](https://admin.shopify.com/apps/supercycle/rentals) table.

*** ### Update item processing state Update processing state from the [Warehouse](#warehouse) field. **Update status** action from the **Actions** options on the [Inventory](https://admin.shopify.com/apps/supercycle/items) table.

**Update item status** action from the **Actions** options on the [Cycles](https://admin.shopify.com/apps/supercycle/rentals) table.

*** ### Update item warehouse location Update location from the [Location](#location) field. **Update location** action from the **Actions** options on the [Inventory](https://admin.shopify.com/apps/supercycle/items) table.

Move items between warehouses directly from the scanner. From the item detail screen, press the warehouse row to open the warehouse picker, choose the destination, then press **Save changes**. From a [multi-scan session](/documentation/manage/scanner/scanner#scan-modes), press **Warehouse** in the bulk action bar, pick the destination warehouse, and apply — every selected item is moved in one call. See [Bulk actions](/documentation/manage/scanner/scanner-actions#bulk-actions). *** ### Update item tags Update tags from the [Tags](#tags) field. Use the [`add_tag`](/ai/operators-mcp/tools#tags) or [`remove_tag`](/ai/operators-mcp/tools#tags) tool with: * `resource_type` - `item` * `resource_id` - Item ID (e.g. `#1042`) * `tag` - Tag title to add or remove Use the [Update an item](/api-reference/admin/items/update-an-item) endpoint with the `tagsAttributes` parameter. *** ### Update item product You can reassign one or more items to a different product/variant. This is useful when items have been mis-tagged against the wrong product, when a product has been split or merged in Shopify, or when you want to consolidate items under a single canonical variant. When you change the variant on an item, the underlying product link is updated automatically — the product is derived from the chosen variant, so you only need to pick the variant. Affected products are re-ingested so their availability and inventory counts stay in sync. Update the variant from the [Variant](#variant) field on the item's page. The product is updated automatically to match the chosen variant. **Update product** action from the **Actions** options on the [Inventory](https://admin.shopify.com/apps/supercycle/items) table.

Tick the items you want to reassign in the Inventory table. Open the **Actions** menu and select **Update product**. Search for a product in the variant picker and choose the target variant. The modal previews the product image, product title, variant title, and SKU so you can confirm you've selected the right one before saving. Save to assign that variant to every selected item. The product link on each item is derived from the variant automatically, and the affected products are re-ingested. Your selection is cleared once the update completes. ***