Collections

A collection is an ordered, flat group of products. Use it for a deliberate merchandising set such as “New arrivals” or “Summer edit”, where parent-child navigation would not express the relationship.

Membership and order

Products carry collection associations, and a collection exposes its products in a stored order. Thor’s public Admin API provides create, update, delete, and product reorder operations. It does not expose a rule definition that automatically maintains collection membership, so integrations should treat membership as explicitly managed catalog data.

A product can belong to multiple collections and categories. Use categories for durable navigation, collections for curated groups, attributes for structured choice, and tags for lightweight labels.

Storefront visibility

A collection being queryable does not make every member visible. Each product and variant still needs active status, a publication in the store’s distribution context, and the context required for price and availability. The Storefront collection and collections queries return the collection surface; product search can filter with collection_id.

Example

For a “Desk refresh” collection:

  1. Create the collection with slug desk-refresh.
  2. Associate a lamp, desk mat, and organizer through their product updates.
  3. Use collectionReorderProducts to place the hero product first.
  4. Query the collection and its products through the same store, price, country, currency, and locale context used by the storefront.