Products, variants and collections: the parts, in plain words

51 parts and 15 phrases. Apps in this area include Shopify products, BigCommerce catalogue, Akeneo, Plytix, Metafields Guru, Salsify.

The productcatalog.productShowWhat one product record holds before any variant is added.

Product detailscatalog.product.detailsShowThe text and identity fields of one product.

How to extend

SlotMany side by sideadmin.slot.product.block storefront.slot.product.below_descriptionA plugin adds its own panel to the product editor or a block under the description.
EventMany side by sideevent.product.created event.product.updatedA plugin reacts when a product is created or edited, for example to push it elsewhere.
Assistant toolMany side by sideupdateProductContentsetSeoMetaThe assistant drafts product text and search titles through these tools, and the operator approves them.

Part	Litestore today	How to extend
Product title`catalog.product.details.title`The title is the product's name as shoppers read it on cards, the product page and receipts.	Core`modules/products/admin/product-form.tsx`	Slot · manyEvent · manyAssistant tool · many
Description`catalog.product.details.description`The description holds the formatted text about the product shown on its page.	Core`modules/products/storefront/product-details-section.tsx`	Slot · manyEvent · manyAssistant tool · many
Address name`catalog.product.details.url_slug`The address name is the short text in the product's web address, such as /products/linen-shirt.	Core`modules/products/admin/schema.ts`	Slot · manyEvent · manyAssistant tool · many
Old address redirect`catalog.product.details.redirect_on_rename`An old address redirect sends visitors from a product's previous handle to its current one after a rename.	Core`modules/storefront/slug-redirects.ts`	Slot · manyEvent · manyAssistant tool · many
Search title and description`catalog.product.details.seo_fields`These fields hold the title and summary that search engines show for the product page.	Core`modules/storefront/seo`	Slot · manyEvent · manyAssistant tool · many
Vendor`catalog.product.details.vendor`The vendor field records which seller or brand supplies the product.	Core`modules/vendors`	Slot · manyEvent · manyAssistant tool · many
Translated text`catalog.product.details.translation`A translation stores the product's title and text in another language for shoppers who browse in it.	Core`modules/markets/translations`	Slot · manyEvent · manyAssistant tool · many
Product kind`catalog.product.details.fulfilment_kind`The product kind marks a product as physical, digital or a service, which sets what happens after it is paid for.	Core`modules/orders/fulfillment-dispatch.ts`	Slot · manyEvent · manyAssistant tool · many
Digital file delivery`catalog.product.details.digital_delivery`Digital file delivery sends the buyer a download link or licence key once the order is paid.	Plugin	Slot · manyEvent · manyAssistant tool · many

Product mediacatalog.product.mediaShowThe pictures and videos attached to a product.

How to extend

ProviderOne per storemedia storageThe file store behind uploaded pictures can be swapped for another storage service.
Assistant toolMany side by sidefindMediaThe assistant looks up stored media through this tool.

Part	Litestore today	How to extend
Product image`catalog.product.media.image`A product image is a picture file attached to the product, shown in its gallery and on cards.	Core`modules/products/storefront/product-gallery.tsx`	Provider · oneAssistant tool · many
Main image`catalog.product.media.primary_image`The main image is the one picture shown first on product cards and in shopping feeds.	Core`modules/integrations/platforms/product-sync.ts`	Provider · oneAssistant tool · many
Product video`catalog.product.media.video`A product video is a moving clip attached to the product and played in its gallery.	Core`modules/media`	Provider · oneAssistant tool · many
Alt text`catalog.product.media.alt_text`Alt text is a short written description of an image read aloud by screen readers.	Core`modules/media`	Provider · oneAssistant tool · many
Variant image`catalog.product.media.variant_image`A variant image is a picture tied to one option value, such as the red version, and shown when that value is picked.	Plugin	Provider · oneAssistant tool · many

Attributes and tagscatalog.product.attributesShowStructured facts about a product beyond its title and text.

How to extend

SlotMany side by sidestorefront.slot.product.below_descriptionA plugin renders extra structured facts on the product page.

Part	Litestore today	How to extend
Specification`catalog.product.attributes.specification`A specification is a named fact about the product, such as material or weight, shown in a table on its page.	Core`modules/products/specifications.ts`	Slot · many
Custom field`catalog.product.attributes.custom_field`A custom field is an extra typed value a store defines for its products, such as a washing guide or a size chart file.	Plugin	Slot · many
Tag`catalog.product.attributes.tag`A tag is a free text label on a product used for search, filters and grouping.	Core`modules/products/admin/tag-crud.ts`	Slot · many
Cost price`catalog.product.attributes.cost_price`The cost price records what the store pays for one unit, used to calculate margin.	Core`modules/products/pricing/core.ts`	Slot · many

Variantscatalog.variantShowThe buyable versions of a product: options, identifiers and prices.

Optionscatalog.variant.optionsShowThe choices a shopper makes on a product, such as size and colour.

How to extend

SlotOne per storestorefront.slot.product.variant_pickerA plugin replaces how option choices are drawn on the product page.

Part	Litestore today	How to extend
Option`catalog.variant.options.option`An option is a named choice on a product, such as Size or Colour.	Core`modules/products/options/option-crud.ts`	Slot · one
Option value`catalog.variant.options.value`An option value is one choice within an option, such as Medium or Blue.	Core`modules/products/admin/option-value-editor.tsx`	Slot · one
Colour swatch`catalog.variant.options.swatch`A colour swatch shows an option value as a coloured dot taken from a stored colour code instead of a word.	Core`modules/products/admin/hex-color-field.tsx`	Slot · one
Shared option list`catalog.variant.options.shared_option`A shared option list stores options and their usual values once so many products reuse the same names.	Core`modules/products/options`	Slot · one
Variant`catalog.variant.options.variant`A variant is one buyable combination of option values, with its own SKU, price and stock.	Core`modules/products/admin/variant-crud.ts`	Slot · one
Variant picker`catalog.variant.options.picker`The variant picker is the control on the product page where the shopper picks option values to reach one variant.	Core`modules/products/storefront/variant-picker.tsx`	Slot · one

Identifiers and limitscatalog.variant.identityShowThe codes and per-order rules attached to each variant.

How to extend

Core onlyThe SKU is the matching key for imports, feeds and stock, so its rules stay in core.

Part	Litestore today	How to extend
SKU`catalog.variant.identity.sku`The SKU is the store's own unique code for one variant, used to match it in stock, imports and feeds.	Core`modules/products/admin/variant-sku.ts`	Core only
Barcode number`catalog.variant.identity.barcode`The barcode field holds the variant's GTIN, EAN, UPC or ISBN number as printed on the packaging.	Plugin	Core only
Variant weight`catalog.variant.identity.weight`The weight field records how heavy one unit of the variant is, for shipping rates and labels.	Plugin	Core only
Quantity limits`catalog.variant.identity.order_limits`Quantity limits set the smallest and largest number of a variant allowed in one order.	Core`modules/checkout/storefront/purchase-eligibility.ts`	Core only
Variant on or off`catalog.variant.identity.active`The active flag turns one variant off so it cannot be bought while the product stays live.	Core`modules/products/admin/variant-row-actions.tsx`	Core only

Pricescatalog.variant.priceShowWhat each variant costs and when a lower price applies.

How to extend

Assistant toolMany side by sideproposeProductPriceUpdateThe assistant proposes a price change that only runs after the operator approves it.
EventMany side by sideevent.product.price_droppedA plugin reacts when a price goes down, for example to notify shoppers.

Part	Litestore today	How to extend
Regular price`catalog.variant.price.list_price`The regular price is what one unit of the variant normally costs.	Core`modules/products/pricing/core.ts`	Assistant tool · manyEvent · many
Sale price`catalog.variant.price.sale_price`The sale price is a lower price shown next to the struck-through regular price.	Core`modules/products/pricing/sale-info.ts`	Assistant tool · manyEvent · many
Sale window`catalog.variant.price.sale_window`The sale window holds a start and end time, and the sale price applies only between them.	Core`modules/products/pricing/core.ts`	Assistant tool · manyEvent · many
Price list`catalog.variant.price.price_list`A price list holds different prices for a group of buyers, such as wholesale customers.	Plugin	Assistant tool · manyEvent · many
Bulk price edit`catalog.variant.price.bulk_edit`A bulk price edit changes the price of many variants at once, by an amount or a percentage.	Plugin	Assistant tool · manyEvent · many

Organising the cataloguecatalog.organiseShowThe structures that group products for shoppers and staff.

Categories and taxonomycatalog.organise.categoryShowThe fixed tree a product is filed under.

How to extend

SectionMany side by sidestorefront.section.categoriesThe categories section shows a grid of categories on any storefront page.

Part	Litestore today	How to extend
Category tree`catalog.organise.category.tree`The category tree is a set of nested categories, each with a parent, such as Clothing > Shirts.	Core`modules/catalog/admin/categories/crud.ts`	Section · many
Standard taxonomy`catalog.organise.category.standard_taxonomy`A standard taxonomy is a published category list, such as Google's product categories, that the store picks its categories from.	Core`modules/catalog/taxonomy/google-taxonomy.ts`	Section · many
Category page`catalog.organise.category.page`A category page lists the published products filed under one category.	Core`modules/catalog/storefront/categories`	Section · many

Collectionscatalog.organise.collectionShowHand-picked or rule-based groups of products shown together.

How to extend

EventMany side by sideevent.collection.published event.collection.unpublishedA plugin reacts when a collection goes live or comes down.
SectionMany side by sidestorefront.section.products storefront.section.lookbook storefront.section.bundle storefront.section.spotlightThese storefront sections show a set of products on any page.

Part	Litestore today	How to extend
Manual collection`catalog.organise.collection.manual`A manual collection holds the products staff add to it one by one.	Core`modules/catalog/admin/collections/collection-products.tsx`	Event · manySection · many
Rule-based collection`catalog.organise.collection.rule_based`A rule-based collection adds every product that matches set conditions, such as a tag or a price range, and drops those that stop matching.	Plugin	Event · manySection · many
Collection order`catalog.organise.collection.manual_order`The collection order is the position staff give each product inside a collection.	Core`modules/catalog/admin/collections/collection-products.tsx`	Event · manySection · many
Scheduled collection`catalog.organise.collection.scheduled`A scheduled collection stores a go-live time and is published by a timed job when that time passes.	Core`jobs/cron.publish-scheduled-collections.ts`	Event · manySection · many
Product set`catalog.organise.collection.product_set`A product set is a collection that lists products meant to be bought together, with a quantity for each and a shown total.	Core`modules/storefront/sections/product-set.tsx`	Event · manySection · many
Styled picture collection`catalog.organise.collection.styled_images`A styled picture collection is a collection laid out as styled pictures with the products in each picture linked.	Core`modules/storefront/sections/media-pinned.tsx`	Event · manySection · many
Collection page`catalog.organise.collection.page`A collection page lists a collection's products under its own address and search title.	Core`modules/catalog/storefront/collections`	Event · manySection · many

Status and publishingcatalog.publishingShowWhether a product can be seen and bought, and the labels shown on it.

How to extend

EventMany side by sideevent.product.published event.product.archivedA plugin reacts when a product goes live or is archived.
SlotMany side by sidestorefront.slot.listing.card_badgeA plugin adds its own label to product cards.

Part	Litestore today	How to extend
Draft`catalog.publishing.draft`A draft product is saved in the admin but not shown or sold on the storefront.	Core`modules/products/visibility.ts`	Event · manySlot · many
Published`catalog.publishing.published`A published product is listed on the storefront and can be bought.	Core`modules/products/visibility.ts`	Event · manySlot · many
Archived`catalog.publishing.archived`An archived product is kept for past orders and reports but removed from the storefront.	Core`modules/products/visibility.ts`	Event · manySlot · many
Hidden product`catalog.publishing.hidden`A hidden product stays published but is left out of listings, search and feeds.	Core`modules/products/visibility.ts`	Event · manySlot · many
Scheduled product`catalog.publishing.scheduled_product`A scheduled product stores a future publish time and goes live when it passes.	Plugin	Event · manySlot · many
Product label`catalog.publishing.computed_badge`A product label is a short tag on a card, such as New, Sale ends soon or Bestseller, calculated from the product's dates, prices and sales.	Core`modules/products/social-proof.ts`	Event · manySlot · many
Bulk product action`catalog.publishing.bulk_action`A bulk product action adds many selected products to a collection or deletes them at once.	Core`modules/products/admin/product-batch-bar.tsx`	Event · manySlot · many

Phrase	Made of
smart collections	catalog.organise.collection.rule_based
automated collections	catalog.organise.collection.rule_based
metafields	catalog.product.attributes.custom_field
variant swatches	catalog.variant.options.swatch catalog.variant.options.picker
compare-at price	catalog.variant.price.list_price catalog.variant.price.sale_price The compare-at price is the higher, struck-through price; the selling price sits beside it.
scheduled sale	catalog.variant.price.sale_price catalog.variant.price.sale_window
product taxonomy	catalog.organise.category.standard_taxonomy catalog.organise.category.tree
product badges	catalog.publishing.computed_badge
GTIN	catalog.variant.identity.barcode
product specifications	catalog.product.attributes.specification
variant images	catalog.product.media.variant_image
digital products	catalog.product.details.fulfilment_kind catalog.product.details.digital_delivery
bulk editor	catalog.publishing.bulk_action catalog.variant.price.bulk_edit
minimum order quantity	catalog.variant.identity.order_limits
URL redirects	catalog.product.details.redirect_on_rename

Products, variants and collections

What the phrases mean

Phrases left out

Sources