In this section · 4 articles

How the Product Catalog works

The Product Catalog lists what you sell: products with their variants, categories, brands, collections, prices, files and bundles. Here's how the pieces fit, what CRM quotes and Billing take from it, and what you can manage on screen today.

Applies to
Product Catalog 1.3 and later
Who can do this
Platform owner, Administrator, Team member
On this page

In short

The Product Catalog is the list of things your business sells: physical goods, digital downloads, services, subscriptions, bundles, or anything in between. It describes each product once, so that other add-ons, such as CRM when you build a quote, can offer it without keeping their own copy.

It describes products. It doesn't take orders, hold stock, raise invoices or take payments. Those belong to other add-ons.

How it works

The parts

PartWhat it isWhere you manage it
ProductOne thing you sell, with a name, address (slug), descriptions, specifications and a status.Catalog › Products
VariantOne version of a product with its own SKU, such as the red, medium T-shirt.The product's Variant matrix
CategoryA place in your product tree, such as Clothing › T-shirts. Categories can nest up to 6 levels.Catalog › Categories
BrandWho makes the product.Catalog › Brands
CollectionA group of products, either picked by hand or matched by rules, such as "all digital products".Catalog › Collections
PriceWhat a product or variant costs in one currency: a List price, an MSRP or a Cost.No screen yet. See below.
MediaImages, videos, documents and digital assets for a product.The product's Media
Bundle contentsThe products, or items from other add-ons, that a bundle product contains.The product's Bundle contents
Diagram of a product at the centre with its variants, media, prices and bundle contents below, and the category tree that holds it, the brand that makes it and the collections that group it above.

A product's status

A product is always Draft, Active or Archived. You don't set this on the form.

StatusMeaning
DraftBeing prepared. Other add-ons can't offer it. Every new product and imported product starts here.
ActivePublished and available to sell.
ArchivedWithdrawn from sale. Quotes and invoices that already include it keep it.

The product list offers Publish and Archive for this, but in Product Catalog 1.4.0 they don't change the product yet: you see 1 processed and its status stays as it was. There's no other way on screen to change a product's status, so products created on screen stay Draft. See Add and publish a product.

Once a product has been published, its Slug can't be changed, because links to it would break.

Type and capabilities

A product's Type (Physical, Digital, Service, Subscription, Bundle or Hybrid) is a label for filtering and reports. It doesn't decide what the product does. That's set by capabilities: Shipping, Inventory, Subscription, Licence, Usage and Digital delivery. A product can have any mix of them.

The product form has no field for capabilities in Product Catalog 1.4.0, so products created on screen have none.

Prices

Each price answers one question, in one currency:

KindMeaning
ListWhat you sell it for. This is the price other add-ons use.
MSRPThe maker's suggested price, for comparison.
CostWhat it costs you. Never used as a selling price.

Prices are kept per currency and never converted. A product with no List price in the currency asked for counts as unpriced, not free.

No screen in Product Catalog 1.4.0 adds or changes prices, so products created on screen have no price. See A product is missing or unpriced in a quote.

What other add-ons take from the catalogue

CRM quotes

When you add a line to a quote in CRM, the product search offers only Active products, found by name or slug. For the chosen product, the line takes:

On the quote lineFrom the product
Name and descriptionName and Short description
SKUThe default variant's SKU, if it has variants
Unit priceThe List price in the quote's currency. Without one, the line is added unpriced and you enter the price yourself.
Tax codeTax class

A price in another currency is never converted: the line is added unpriced instead. A bundle is quoted at its own List price, as one line; its contents aren't added up.

Archiving a product doesn't change quotes that already include it: they keep the name it was sold under. It just stops being offered for new lines.

Monetization plans arrive daily as Draft products; only Active products are offered to CRM quotes, passing name, SKU, List price and Tax class to the quote line, which Billing documents keep.

Billing

Billing doesn't read the catalogue itself. A document line keeps the description and price it had on the quote, so later changes in the catalogue don't change documents.

Tax class is a label, such as standard or reduced, that travels with the product onto quote lines. The field's help says Billing turns it into a tax rate, but Billing 2.0.0 ignores it and taxes every line of a document by the same rule. See How tax is calculated.

Products copied from other add-ons

Every day, your Laramin copies items that other add-ons sell into the catalogue as Draft products. Today that's Monetization's plans and offerings. You can then describe them and add files. A copy is never overwritten: later changes in the other add-on only update when it was last checked. The Origin column on the product list shows where a product came from.

What you can manage on screen today

You canYou can't yet
Add, edit and delete productsPublish, archive or copy a product
Create categories, brands and collectionsSet prices
Upload images, documents and digital assetsChoose a product's categories or capabilities
Add bundle contentsCreate attributes (the axes variants are made from, such as size)
Generate variants from existing attributesEdit or price single variants
Add products to a manual collection, or link related products

The catalogue can hold everything in the right-hand column, but no screen in Product Catalog 1.4.0 does it. Publish, Archive and Duplicate are on the product list, but they answer 1 processed and change nothing. Ask your platform owner how products are being loaded into your catalogue.

How it relates to

  • Custom Fields. Fields you add for Product appear in the product form's Additional fields card. See How custom fields work.
  • Permissions. Each screen and action has its own permission, and some can be limited to products a person created. See Product Catalog fields and permissions.
  • Workspaces. The catalogue is shared by your whole Laramin.
  • Turning it off. Products stop being offered to quotes. Existing quotes keep their lines. See Disable or delete an add-on.

Next steps