Your Bazaar catalog is built from two kinds of record:

  • Item. A single thing a buyer can download or receive: a track, an ebook, a sample pack, a brush set. Each item is one file, or something that isn’t a file, such as a license key.

  • Product. A named group of one or more items sold together: an album, a bundle, a box set.

A product lists its items in display order. One item can appear in more than one product.

Items

An item record holds a title and optional details you write yourself:

  • Category and tags: use whatever words fit your shop. There’s no fixed list.

  • Description.

  • File details, for items that are files: the format (such as flac or pdf), a SHA-256 checksum and a content ID (CID). These let anyone check that the file they downloaded is the one you published.

You can edit an item’s title, description, category and tags at any time. The file details can’t be changed. To replace a file, publish a new item that points back to the one it replaces. Bazaar never deletes the old item, so earlier versions stay traceable.

Products

A product record holds a title, an optional description and tags, and its list of items. You can change that list later. Buyers who already purchased keep exactly what they bought:

  • An item you add reaches future buyers only.

  • An item you remove stays downloadable for everyone who bought before you removed it.

This works because each receipt records the exact list of items at checkout.

Why start with a product, even for a single

Even a one-track single works best as a product with one item in it. The product is where the rest of the release lives:

  • Cover art. Artwork belongs to the product. Its items show that artwork wherever they appear in your storefront, even when sold on their own.

  • Included extras. Liner notes, a poster PDF or anything else you want buyers to have goes in every buyer’s download package. Extras aren’t items, so they don’t take up a spot in the release’s item list.

  • Room to grow. If the single later becomes part of an EP, you add items to the product you already have.

How items are sold

You sell things through listings, and each listing has its own price and license. That gives you three options:

  • Sell the product. The buyer gets every item in it.

  • Also sell items individually. An item in a product can have its own listing, such as a single track from an album. If you pause the product’s listing, these pause with it.

  • Sell an item independently. An item can have its own listing, with its own price and license, separate from the product’s listing.