Sign in to follow this  

Viewer-managed Marketplace



The new Viewer-managed Marketplace feature allows you to easily manage your inventory on the Second Life Marketplace using the Second Life Viewer.  Items no longer need to be loaded into the Merchant Outbox or a Magic box, and are instead sold directly from your inventory.  

The Marketplace Listings window

The Marketplace Listings window is an extension of your Second Life inventory that allows you to manage all inventory in your Second Life Marketplace store.  By dragging and dropping items from your inventory window into the Marketplace Listings window, you can immediately begin setting up new listings, add updated versions of your existing products, and even list or unlist items on the Marketplace Store.  You can access the Marketplace Listings window by choosing Me > Marketplace listings from the top menu bar of the Second Life Viewer.

Version folders

Each Marketplace Listing folder contains one or more version folders that allow you to easily manage updated versions of a product without creating a new listing.  Version folders look like normal inventory folders with three lines drawn on them, like this: Inv_VersionFolderClosed.png.  Only one version folder may be active at a time for each listing; when a customer buys your product, they receive a copy of the active version folder and its contents.

To activate a version folder for a Marketplace Listing, right-click the appropriate version folder and choose Activate.  If a listing folder contains only one version folder, it is activated automatically.  Currently active version folders are marked by the word "(active)".

Note: When you drag objects from your regular inventory to a version folder, they are moved, not copied.  This means that they no longer appear in your main inventory and will be lost permanently if deleted from their respective version folder.  

You may instead copy an item from your inventory to the Marketplace Listings window by right-clicking the item in your inventory and choosing Copy to Marketplace Listings.

Stock folders

You can now use the Marketplace Listings window to sell a limited stock of no-copy items.  No-copy items that you drag into the Marketplace Listings window are automatically placed into a stock folder.  Stock folders look like normal inventory folders with a grid of squares on them, like this: Inv_StockFolderClosed.png.  Stock folders also show the number of items they contain next to their names.  For example, "Example Crate (stock=7)".

Each stock folder must be inside a version folder, and represents the sale of a single item in the listing, even though there may be many items inside the stock folder.  For example, if your active version folder consists of a copiable notecard and a stock folder containing 25 no-copy objects, each customer will receive a copy of the notecard and one randomly selected object from the stock folder until no items remain in the stock folder.

The no-copy items within a stock folder must be of the same inventory type, but may have different names.  For example, some identical limited-run items may have serial numbers written into their object names, but they can still be sold from the same stock folder.

Note that while it is still possible to sell a limited quantity of copiable items using the appropriate listing field, the quantity of items available from a stock folder is determined by the number of items in the folder and cannot be changed using the Available quantity listing field.

When a stock folder runs out of no-copy items, the Marketplace de-lists your listing and sends an email alert reminding you to add more units.

Creating a new listing

Follow these steps to create a listing for a new product on the Second Life Marketplace:

  1. Open the Marketplace Listings window in the Second Life Viewer by choosing Me > Marketplace listings from the top menu bar.
  2. Open your Inventory window by choosing Me > Inventory from the top menu bar.
  3. Drag your product from the Inventory window to the section of the Marketplace Listings window labeled Drop folders here to create new listings. It now appears under the Unassociated tab.
  4. Under the All or Unassociated tabs, right-click the listing folder containing your product and choose Create listing.  The folder is moved to the Unlisted tab and now displays a listing number.
  5. Under the All or Unlisted tabs, the single version folder Inv_VersionFolderClosed.png inside the listing folder is automatically made active.
  6. Right-click the listing folder or version folder and choose Edit listing to fill out the required listing fields on the Marketplace website.  If you try to list your product before filling out the required listing fields, you will receive an error message explaining which fields still require input.  Click the Update button to save your listing.
  7. On the All or Unlisted tab of the Marketplace Listings window, right-click the listing folder and choose List to list your product on the Second Life Marketplace.  You may still list or unlist items from the Marketplace website as well.

Changing versions of a listed item

 As you develop updates for your products, you can easily update your Marketplace listings with the new items without deleting the older versions:

  1. Open the Marketplace Listings window in the Second Life Viewer by choosing Me > Marketplace listings from the top menu bar.
  2. Open your Inventory window by choosing Me > Inventory from the top menu bar.
  3. Drag your updated product from your Inventory window to the listing folder for that product in the Marketplace Listings window; this creates a new, inactive version folder containing the updated product.
  4. Right-click the new folder and choose Activate to make it the active version folder for that listing.  All new sales through the associated Marketplace listing will deliver products from the active version folder.

At any time, you can revert your listing to sell a previous version of your product by right-clicking its version folder and choosing Activate.  

Changing the item associated with a listing

Under rare circumstances, you may need to completely change the item associated with a Marketplace listing.   The most common reasons for needing to change the item associated with a listing are:

  • If you accidentally deleted the inventory folder associated with a listing and need to re-associate items with an existing listing.
  • If you are manually migrating from a previous Marketplace delivery system, such as Magic Box or Merchant Outbox.  Merchant outbox listings will eventually be migrated to Viewer-managed Marketplace automatically, but Magic Box listings must be migrated manually.

 To associate a listing folder with a pre-existing Marketplace listing:

  1. In the Second Life Viewer, choose Me> Marketplace listings.
  2. Find the listing number in parentheses next to your existing listing.  For example, "Example Crate (3757)".  For Merchant Outbox or Magic Box listings, see Finding the listing ID of a Magic Box or Merchant Outbox listing.
  3. Click the Unassociated tab of the Marketplace listings window.
  4. Right-click an unassociated item you wish to associate with your listing and choose Associate listing.
  5. In the Associate Listing window that appears, enter the listing ID of your existing listing and click OK.
  6. The unassociated item now replaces the existing item (if any) in the Marketplace listing.

Note that changing the item associated with a listing in this way causes the item to become unlisted because you are replacing the active version folder.  You will need to activate a new version folder and re-list the item as described in Creating a listing.

Finding the listing ID of a Magic Box or Merchant Outbox listing

You can also associate new items with existing Magic Box or Merchant outbox listings, allowing you to migrate your items to the Marketplace Listings window.  The process is nearly the same as described above, except that in order to find the listing ID of these older listings, you must look at the URL for the listing on the Second Life Marketplace website.

The listing ID can be found after the last forward slash "/" in the URL of any item listing on the Second Life Marketplace.  For example, the listing ID of the product found at is "2632864".

If the inventory for your listing no longer exists and there is no listing page, you can still access the listing ID by choosing Actions > Edit next to the item in your Merchant Home on the Marketplace website.  When accessing the listing ID in this way, the ID will be the last number in the URL before the word "edit".  For example, the listing ID of an object whose edit link is is "2632864"

Video tutorial series

We've created a series of videos to walk you through the basics of the Viewer-managed Marketplace features.  Click the links below to view these video tutorials on YouTube:

Migrating from Direct Delivery or Magic Box to Viewer-Managed Marketplace

 Viewer-managed Marketplace will be in beta for at least one month.  The next steps after beta will be:

  • About one month after the beta has been opened to all merchants, the beta period ends.
  • About one week after the full release of Viewer-managed Marketplace, automated migration of Direct Delivery listings begins.  Magic Box listings must be migrated manually as described in Changing the item associated with a listing.
  • After migration is completed, Xstreet and Magic Boxes are shut down.

You may manually migrate your inventory from Direct Delivery or Magic Box listings as described above in Changing the item associated with a listing.  Magic Box listings must be migrated manually, but Direct Delivery listings will be migrated automatically-- with plenty of warning.

If you choose to have your listings automatically migrated, listing and version folders are automatically created for you.  Both these folders are named after the "SL Object Name" you see on your listing.

We need to prevent any changes to listings during the automatic migration.  Items in your store may still be purchased during the migration period, but any item that is currently being migrated will be unavailable.

We cannot provide an exact date or time when your listings will be migrated, but we will alert you when we start and when the migration has completed.  We plan to run migrations during our lowest traffic times: Between 9:00 PM and 9:00 AM Pacific.

Third-Party Viewer developer resources

There are two API wiki pages targeted at Third-Party Viewer developers.  This API documentation is helpful for developers who want to integrate Viewer-managed Marketplace into their Third-Party Viewers, but is not necessary for most Marketplace merchants or their customers:

Exporting data from Xstreet

You may export your purchase and sales transaction history from Xstreet.

To export your purchase history:

  1. Log into the Xstreet SL web site.
  2. Mouse over the Shopping option in the menu at the top of the page.
  3. Click Purchases.
  4. On the Marketplace Purchase History Page, adjust the date range to see all purchases that occurred on the SLExchange/Xstreet SL web site.
  5. Copy and paste this information into a spreadsheet.

To export your sales history:

  1. Log into the Xstreet SL web site.
  2. Mouse over the Shopping option at the top of the page.
  3. Click My Sales & Inventory.
  4. Adjust the date range to see all sales within the range.
  5. Click View CSV Output to output your sales history date in CSV format.


Sign in to follow this  

User Feedback

There are no comments to display.