# Products and orders

Choose how you sell each product, prepare its variants, and keep a clear record of every sale.

<a id="products"></a>
## Choose a product type

Choose Simple when you sell one version of a product. Choose Variants when versions need their own titles, descriptions, photos, prices, and availability. The type is fixed after you create the product. Products created before this choice was introduced behave as Simple products.

A Simple product needs a name, description, price, and available inventory before you publish it. A product with variants needs a name and at least one variant ready for sale. You can describe and photograph each variant separately, so a product-wide description and gallery are not required.

- Use Simple for one version with one current price and inventory total.
- Use Variants when customers need to choose between versions, such as different frames or sizes.

<a id="attributes"></a>
## Define product attributes

An attribute names a characteristic customers may choose, such as Frame or Media Size. Create it once in your project and add its allowed values, such as Wood and Plastic. Assign that attribute to a product to make it part of the product’s shared list of choices. You can choose which attributes shoppers see.

Every variant of that product shows every attribute in the shared list. If a variant has no value for one of them, the product editor shows “Value required” so you can complete it. Each complete combination of values must be different from the other variants on the product, unless an older variant has been archived.

- Adding an attribute to one product makes it visible on all of that product’s variants; you assign a value separately on each variant.
- You can add an extra descriptive attribute to one variant without making it a choice shared by every variant.
- You can rename an attribute and add allowed values later. Values already used on an order are protected.

<a id="variants"></a>
## Prepare a variant for sale

Add Variant creates a blank variant with Selling off. Fill in its product attribute values in the Attributes tab. Use Merchandising for its title, description, and photos. Set its price and either a positive available quantity or Unlimited supply above the tabs.

Selling becomes available when every shared attribute has a valid value, the variant has a title and description, a positive price is active, and stock is available or supply is unlimited. A product with variants can be published once at least one variant is selling and every selling variant is ready.

- You can leave a new variant incomplete while you work on it; it will not start selling on its own.
- Once a variant appears on an order, its selected attributes, photos, and supply policy are fixed. You can still change its title, description, current price, tracked stock, or Selling status.
- A variant used on an order cannot be removed. Turn Selling off to stop offering it to shoppers.

<a id="prices"></a>
## Manage price and availability

A Simple product has one price and inventory total. For a product with variants, each variant has its own price and availability. A saved price is shown as a value; use Edit price to change an unused price. If that price has already been used on an order, use Replace price instead. The previous price remains in the history of that sale.

For tracked stock, set the current available quantity. If you do not track a limit, choose Unlimited supply. Changing a current price or stock quantity does not change an existing order.

- A variant needs a positive price and positive tracked availability, or Unlimited supply, before Selling can be enabled.
- The price charged on an order stays with that order even when you replace the price later.

<a id="orders"></a>
## Build a manual order

Start an order as a draft. Add a product and, for a product with variants, choose the exact variant and quantity. You can also add sales tax, saved fees, and shipping charges. Fill in the billing customer, shipping destination, and any required customer PO number before generating an invoice.

A manual draft order can include a draft variant once all its product attribute values and an active price are set, even if its title or description is still blank. An archived variant cannot be added to a new order.

- Choose a variant explicitly for a product with variants; a Simple product needs no variant selection.
- An invoice needs at least one line item and the required customer and address details.
- Payment collection and fulfillment have their own statuses so you can track them separately.

<a id="history"></a>
## Understand what an order keeps

When you add a variant to an order, the line records its chosen attributes, their names and values, the variant title and description when present, and the price charged. Extra descriptive attributes are recorded too. Later edits to the catalog do not rewrite that order line.

This lets an older order show what was selected and charged at the time. An invoice presents the order details for the customer; the order remains the ongoing record for payment and fulfillment.

- If a draft variant has no title or description when it is added, the order keeps the details that were available at that time.
- Removing a line from a draft order does not automatically release variant choices that were locked when the line was added.

<a id="example"></a>
## Example: a framed print

A framed print shows how a shared product attribute and individual variants work together.

1. Create a product with Variants and an attribute named Frame. Add Wood and Plastic as allowed values.
2. Add two blank variants. Set Frame to Wood on one and Plastic on the other. Both variants show Frame because it belongs to the product.
3. Give each variant its own title, description, photo, price, and availability. Turn Selling on when each is ready.
4. When a customer orders the Wood version, the order keeps Wood and the price charged, even if you later rename the attribute or replace the price.
