First Product
Products in Sylius are more than a name and a price. Each product has a type, a set of attributes, channel assignments, tax configuration, and optionally a variant structure for things like sizes and colors. This page covers enough to get your first product live, and explains the concepts behind each decision.
Simple vs. Configurable Products
Every product in Sylius is one of two types, and you choose at creation time.
Simple Product has a single purchasable version. A book with one edition, a service with a fixed price, a digital download, anything where there's no variation the customer needs to choose between.
Configurable Product has one or more Options — size, color, material — and each combination of option values is a Variant. A t-shirt available in S/M/L/XL and three colors is a Configurable Product with 12 variants. Each variant can have its own price, stock level, and shipping weight.
If you're not sure which to use: start Simple. You can't convert between types after creation, but for a first product Simple is always the right call.
Key fields explained
Price Set per Channel. If your store runs multiple Channels — different countries or contexts — each Channel can have a different price for the same product.
Channels Which storefronts this product appears in. A product not assigned to a Channel is invisible to customers on that Channel. For your first product, assign it to your default Channel.
Taxes Assign a Tax Category to apply the correct tax rate at checkout. Tax rates are calculated based on the customer's Zone — which is why Zones were configured first.
Shipping Mark whether the product requires physical shipping. Products marked as non-shipping skip the shipping step at checkout. Set the weight and dimensions if your shipping methods use them for rate calculation.
Inventory Tracking Enable to track stock levels. When stock reaches zero, the product becomes unavailable for purchase unless you configure a backorder policy.
Creating your first product
Go to Catalog → Products in the admin panel
Click Create and choose Simple Product
Fill in the product name — at minimum in your base locale
Set a price for your default Channel
Assign the product to your Channel
Set the Enabled toggle to on
Save
At this point your product is live and purchasable — assuming you've already configured a shipping method and payment method.
If the product doesn't appear in your shop, check that it's assigned to the correct Channel and that the Channel is enabled.
What's next
This covers the basics of product creation. Sylius's catalog system goes significantly deeper — taxons and category trees, product associations, attribute sets, variant option configuration, and per-channel pricing rules are all covered in The Book.
The Book > Products (login required)
Last updated
Was this helpful?