Skip to content

Virtual Items

Virtual Items are individual digital goods or codes that belong to Virtual Item Lists. Each virtual item represents a unique code, key, or digital product that can be delivered to customers. Virtual items are essential for managing digital inventory such as gift cards, license keys, vouchers, and promotional codes.

Overview

Virtual Items serve as:

  • Individual digital products that can be sold through your store
  • Codes and keys for gift cards, licenses, and promotions
  • Inventory tracking for digital goods
  • Redeemable content that customers receive upon purchase

Each virtual item belongs to exactly one Virtual Item List and inherits the encryption settings of that list for security.

Accessing Virtual Items

Navigate to Catalog Management > Virtual Items from the admin sidebar. This section displays all created virtual items with their status, parent list, and usage information.

Understanding Virtual Items

Virtual Item Properties

Each virtual item contains:

  • Virtual Item List: The parent list this item belongs to (inherited from creation)
  • Code: The unique code or key (e.g., gift card code, license key) - max 50 characters
  • Info: Additional information about the item (e.g., product details, value, expiry)
  • Used: Boolean flag indicating if the item has been redeemed or used

Item Lifecycle

Virtual items follow this typical lifecycle:

  1. Created: New item added to the Virtual Item List as available inventory
  2. Available: Item ready for customer purchase or fulfillment
  3. Used: Item marked as used after customer redeems or activates
  4. Archived: Item remains in system for audit trail

Managing Virtual Items

Reviewing Items

The Virtual Items list displays:

Virtual Items List

  • Virtual Item List ID: The parent list's numeric ID
  • Code: The actual code/key for the item
  • Used: Icon showing if the item has been used (clickable toggle)
  • Created At: Timestamp when item was created (hidden by default)
  • Updated At: Timestamp of last modification (hidden by default)

Creating a Virtual Item

To create a new virtual item:

Create Virtual Item

  1. Click the New Virtual Item button at the top right
  2. Enter the Virtual Item List ID (numeric ID of the parent list)
  3. Leave blank if you want to add items without list association
  4. Or enter the ID of the Virtual Item List to organize it
  5. Enter the Code (required, up to 50 characters)
  6. Examples: "GC-2024-001", "LICENSE-ABC123", "VOUCHER-PROMO"
  7. Should be unique and easy to track
  8. Can include alphanumeric characters and dashes
  9. Enter the Info (required, text area for additional details)
  10. Examples: "Holiday Gift Card - $100 value", "Software License - 1 year", "Promo code - 20% off"
  11. Include any relevant metadata or notes
  12. Toggle the Used status
  13. Disabled (default): Item is available for customer purchase
  14. Enabled: Mark item as already redeemed or used
  15. Click Create to save the item
  16. Click Create & create another to save and immediately add the next item
  17. Click Cancel to discard changes

Editing Virtual Items

To modify an item:

  1. Click the Edit link in the Actions column
  2. Update any fields as needed:
  3. Change the parent Virtual Item List ID
  4. Update the code (use caution if code is already distributed)
  5. Modify the info description
  6. Change the used status
  7. Click Save to apply changes

Important: Changing the code after it's been given to a customer can cause fulfillment issues. Proceed with caution.

Marking Items as Used

Items can be marked as used in two ways:

Method 1: Quick Toggle from List

  1. Click the Used icon/button in the list view
  2. The status toggles immediately between used and unused
  3. No form navigation required

Method 2: Through Edit Form

  1. Click Edit for the item
  2. Toggle the Used switch
  3. Click Save

Use the quick toggle method when you need to quickly mark multiple items as used.

Bulk Marking Items as Used

While there's no bulk status change action, you can:

  1. Use the checkbox to select multiple items
  2. Click Edit for each item to toggle status individually
  3. Or export the list, manually update used status in a spreadsheet, and re-import if supported

Deleting Virtual Items

To remove an item:

  1. Click the Delete button in the Actions column
  2. Confirm when prompted

Important: Deleting a virtual item is permanent. If the item has been distributed to a customer, deleting it will prevent tracking its usage. Consider marking it as used instead.

Searching and Filtering

Search Functionality

Use the search box to find virtual items by:

  • Code: Search by exact or partial code (e.g., search "GC-2024" to find all codes starting with that prefix)
  • The system searches all code values in real-time

Sorting

Click on column headers to sort:

  • Virtual Item List ID: Sort by parent list
  • Code: Alphabetical order of codes
  • Used: Group by used status

Click headers again to reverse sort order.

Column Management

Click the Toggle columns button to show or hide:

  • Virtual Item List ID
  • Code
  • Used
  • Created At
  • Updated At

Hide columns you don't need to simplify your view.

Bulk Actions

Select multiple items using the checkboxes, then use:

  • Delete bulk action: Remove multiple items at once (use carefully!)
  • Export bulk action: Export selected items to a file for backup or analysis

To select all items on the current page, use the checkbox in the table header.

Pagination

Use pagination controls to:

  • Change items per page (5, 10, 25, 50, or All)
  • Navigate between pages