For the complete documentation index, see llms.txt. This page is also available as Markdown.

Shipments

Before customers can complete a purchase, your store needs at least one shipping method. This page explains how shipping works in Sylius and how to configure it.

A shipping method defines how an order can be delivered — and under what conditions it's available. Availability is controlled by two factors:

Zone — a shipping method is available only to customers whose shipping address falls within the method's assigned Zone. A method for "European Union" won't appear at checkout for a customer shipping to the US. This is why Zones were configured first.

Shipping Category — optionally, a method can be restricted to products belonging to a specific Shipping Category. Useful when certain products (e.g. oversized items, hazardous goods) require a dedicated carrier.

Each shipping method also has a calculator that determines the cost. The simplest calculator charges a flat rate per order. More advanced calculators can price per item, per unit weight, or per volume.

Creating a shipping method

  1. Go to Configuration → Shipping Methods

  2. Click Create

  3. Set a name (shown to customers at checkout) and a code (internal identifier)

  4. Assign a Zone — the regions where this method is available

  5. Choose a calculator and set the rate

  6. Enable the method and save

You need at least one enabled shipping method before customers can complete checkout. If your store only ships to one region, one flat-rate method is enough to get started.

What's next

With a payment method and a shipping method in place, your store is ready to accept orders. The next step is creating your first product.

Last updated

Was this helpful?