Skip to content

Virtual Item Lists

Virtual Item Lists allow you to organize and manage collections of virtual items such as gift card codes, license keys, serial numbers, and other digital content. These lists serve as containers for related digital items and include options for encryption to protect sensitive data.

Overview

Virtual Item Lists are useful for:

  • Organizing digital inventory by type or purpose (e.g., separate lists for gift cards, license keys, vouchers)
  • Managing security through optional encryption of sensitive codes
  • Grouping related items for easier management and bulk operations
  • Creating searchable categories for your digital products

Each list can store multiple virtual items and can be configured to encrypt the stored data for enhanced security.

Accessing Virtual Item Lists

Navigate to Catalog Management > Virtual Item Lists from the admin sidebar. This section displays all created virtual item lists with their encryption status and available actions.

Virtual Item Lists

Understanding Virtual Item Lists

What Are Virtual Items?

Virtual items are digital goods or codes that you can deliver digitally to customers. Examples include:

  • Gift Card Codes: Pre-generated codes that customers can redeem for store credit
  • License Keys: Software product keys or activation codes
  • Serial Numbers: Product serial numbers for warranty tracking
  • Voucher Codes: Promotional or discount codes
  • Access Tokens: Digital tokens for access to services or content
  • Digital Files: Links or keys for downloading digital content

List Components

Each virtual item list contains:

  • Name: A descriptive title for the list (e.g., "2024 Holiday Gift Cards")
  • Encrypted: A security toggle to encrypt sensitive data in the list
  • Virtual Items: Multiple digital items/codes belonging to this list

Managing Virtual Item Lists

Reviewing Lists

The Virtual Item Lists view displays:

  • Name: The descriptive name of the virtual item list
  • Encrypted: Icon indicating if the list's items are encrypted (checkmark = encrypted)
  • Action: Edit button for modifying the list

Creating a Virtual Item List

To create a new virtual item list:

Create Virtual Item List

  1. Click the New Virtual Item List button at the top right
  2. Enter the Name for your list (required, up to 100 characters)
  3. Choose a clear, descriptive name
  4. Examples: "Q1 Promo Codes", "Software Licenses", "Gift Card Batch 001"
  5. Toggle the Encrypted option to enable data encryption:
  6. Enabled (toggled on): Items in this list will be stored encrypted for security
  7. Disabled (toggled off): Items will be stored as plain text for easier reference
  8. Click Create to save the list, or Create & create another to save and immediately add another list
  9. Click Cancel to discard changes and return to the list

When to Use Encryption

Enable encryption for:

  • License keys that shouldn't be displayed in plain text
  • High-value gift card codes
  • Sensitive customer data or tokens
  • Any proprietary or confidential digital content

Disable encryption for:

  • Public promotional codes
  • Non-sensitive serial numbers
  • General reference information
  • Items you need quick access to

Editing Virtual Item Lists

To modify a list:

  1. Click the Edit link in the Actions column
  2. Update the list name or encryption setting
  3. Click Save to apply changes

Note: Changing the encryption setting on an existing list only affects future items added to the list. Existing items retain their original encryption status.

Toggling Encryption

You can quickly toggle the encryption status directly from the list view:

  1. Click the Encrypted icon/button for any list
  2. The encryption status toggles immediately without opening the edit form

This is useful for quickly changing settings without navigating to the edit page.

Deleting Virtual Item Lists

To remove a list and all its items:

  1. Click the Delete button in the Actions column (or select multiple lists and use bulk delete)
  2. Confirm the deletion when prompted

Important: Deleting a virtual item list permanently removes all items in that list. This action cannot be undone. Consider exporting the list first if you need to preserve the data.

Working with Virtual Items

While you manage lists here, the actual items (codes, keys, etc.) in these lists are managed in the Virtual Items section. Each virtual item belongs to one virtual item list and inherits the list's encryption settings.

Virtual Item Properties

Each item in a list has:

  • Code: The actual digital item or code (e.g., gift card code, license key)
  • Info: Additional information or metadata about the item
  • Used Status: Whether the item has been redeemed or activated
  • List Association: Reference to its parent virtual item list

Filtering and Searching

Search Functionality

Use the search box to find virtual item lists by:

  • List name
  • Partial name matches (e.g., search "gift" to find "2024 Holiday Gift Cards")

Sorting

Click on column headers to sort:

  • Name: Alphabetical order
  • Encrypted: Grouped by encryption status

Click again to reverse the sort order.

Column Management

Click the Toggle columns button to show or hide columns based on your preference.

Bulk Actions

Select multiple lists using the checkboxes, then use bulk actions to:

  • Delete multiple lists at once (removes lists and all their items)
  • Export lists to a file for backup or reporting

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

Pagination

Use pagination controls at the bottom to:

  • Change the number of lists displayed per page (5, 10, 25, 50, or All)
  • Navigate between pages