Version: 2.11

Products

Introduction

This page contains an alphabetically sorted list of all your products with a picture for each (if set), the product name and type, information on its visibility on your site (if it is published or not), and the product's price.

Managing the list view

Using filters

By default, the page displays all products. You can also use convenient filters to view products by their:

  • Categories

  • Collections

  • Price

  • Product Types

  • Visibility

  • Stock quantity

  • Specific attributes, such as size and material

You can also set up and save custom filters which will be unique to your browser (so other users will not see it).

Editing columns

Another convenient way to manage the view of the product list and adjust it to your current need, is using the column editing feature.

Column grid

Click the Columns dropdown to open a list of available attributes and select the ones you want to use as the columns. Once saved, the product list will be adjusted to reflect your column selection.

You can select up to 16 attributes as columns. The following fixed columns will be displayed regardless of the selection you make:

  • Checkbox column

  • Thumbnail

  • Product Name

  • Actions column

Use the Reset button on the grid to return to default settings (the above mentioned fixed columns plus the following: Product Type, Stock, Price).

For more information on how to set the attribute so it can be used in the column selection list in the Product page, see the description of the Properties card section in the Attributes topic.

Sorting by columns

You can also sort your product list by columns. To do that, click on the column header. Clicking the header again will change the sorting order (ascending/descending).

Product concept

Before filling your shop with products, you need to learn about 3 basic product concepts in Saleor:

  • Product type
  • Product
  • Product variant

Product type

Think about product types as templates for your products. Multiple products can use the same product type.

Product

The product concept reflects the common details of several product variants. When the shop displays the products in the category view, items on the list are displayed as separate products. If the product variant has no overridden property (for example: price specifically set for this variant), the default value is taken from the product.

Product variants

Variants are the most important objects in your shop. All operations on cart or stock utilize variants. Even if you do not set up multiple variants for your product, the store will create one under the hood.

To explain the difference, we will use a bookstore example. Let's imagine you are an owner and one of your products is a book titled "Introduction to Saleor".

The book is available in hard and softcover, so there would be 2 product variants.

To simplify this for the example purposes, let's assume that the type of cover is the only attribute creating separate variants in your store. You would then use product type called “Book”, enable variants, and use the “Cover type” as your variant attribute.

Product attributes

Attributes are shared among all product variants. For example, consider the publisher: all book variants are published by the same company (the publisher is an attribute in this case). Or being back to the hard-/softcover books: the attribute here is a Cover Type and it is common to its variants.

Variant attributes

It’s what distinguishes different variants. For example: for the attribute cover type you will have two variant attributes: hard cover or soft cover.

For more information on the product structure in Saleor, see the Product Types topic.

Stock management

Each product variant has also a stock-keeping unit (SKU).

Each variant holds information about:

  • Quantity at hand
  • Quantity allocated for already placed orders
  • Quantity available

Example

There are five boxes of shoes in your store. Three of them have already been sold to customers but were not yet dispatched for shipment. The stock record is as follows:

  • Quantity is 5
  • Quantity allocated is 3
  • Quantity available is 2

Each variant also has a cost price (the price that your store had to pay to purchase it).

Within a variant, stock information is split between warehouses. Use the Inventory card to define which warehouses carry that particular SKU and what quantities they hold.

Inventory card

note

Even if your product is set to not track inventory, you need to assign it to some warehouses for the product to become available for purchase.

Product availability

A variant is in stock, if it has unallocated quantity.

The highest quantity that can be ordered is the available quantity of product variant.

Allocating stock for new orders

Once a new order is placed, the quantity needed to fulfill each order line is immediately marked as allocated.

Example

A customer places an order for another box of shoes. The stock record is as follows:

  • Quantity is 5
  • Quantity allocated is now 4
  • Quantity available becomes 1

Decreasing stock after shipment

Once order lines are marked as shipped, each corresponding stock record will have both its quantity at hand and quantity allocated decreased by the number of items shipped.

Example

Two boxes of shoes are shipped to a customer. The stock record is now as follows:

  • Quantity is 3
  • Quantity allocated becomes 2
  • Quantity available stays at 1.

How to

How to create a new product

Click Create Product above the main list to enter the product setup page.

Step 1: Fill out the General Information card

Add the name of your product and a description. Use text formatting to make your product descriptions clear and engaging. The eight basic functions are: bold type, italic type, sub-header, second sub-header, quote, bullet point list, numbered list, new text line, and add hyperlink.

Creating effective product names

Make sure that each product has a unique name so site users can find them easily and your administrators can easily manage your store. If you have five t-shirts, do not call them all ‘t-shirt’. Use more engaging and searchable names like black men’s t-shirt, sparkly unicorn girls’ t-shirt, red ladies t-shirt, sports t-shirt, etc.

Writing a good description

Your product descriptions can be cool and fun, or just based on the facts. They represent the tone of your store. Be creative if you like, but be clear and make sure that you have all the information that a buyer needs.

Formatting product description

Step 2: Define pricing

Type the price of your product manually or using the stepper by the currency indicator. If your product is tax-exempt, leave the Charge taxes for this item checkbox empty. If you need to charge taxes, click on the box and a green check mark will appear.

For more information on taxes, see the Taxes topic.

Displaying localized prices

Saleor operates and charges in the store’s default currency but is capable of displaying an estimated amount in the user’s local currency.

  • GeoIP is used to determine the user’s country
  • Locale database (Unicode CLDR) is used to determine the local currency
  • Open Exchange Rates is used to provide up-to-date exchange rates

Step 3: Add optional search engine preview content

Click Edit Website SEO to add a description. If you do not add unique SEO content, details will be taken from the General Information card.

Help search engines find your products

Increase traffic to your store by adding SEO-friendly descriptions for search engines. Write interesting, short content about each product, using keywords that people will use in web searches. Create a unique description for each product so search engines do not think it is duplicated content.

Editing product SEO

Step 4: Organize your product

Categorize your new product using the drop-down menus to assign a relevant Product Type and Category. This is mandatory before you can save the product. You can also optionally assign your product to a Collection.

Step 5: Make your product visible

Once you have set up all your product details, you can choose if it appears for sale or remains hidden from view. If set, it allows you to hold some of your products unavailable to your customers until the publication date. They are simply not listed in your storefront.

Changing product visibility

If you want to push your product for sale, select the Published option.

You also have to choose the availability for purchasing your product. If you select unavailable for purchase, you can set a date when your customers will next be able to buy your product.

To show a product in the product listings, you have to enable the Show in product listings checkbox.

Step 6: Save your new product

Once you have input your minimum required product information, click save in the footer to add it to your catalog and continue with further setup.

Step 7: Add images

Much the same as on social media or other platforms, there are two ways to add an image:

  • Drag and drop a file from a folder on your computer
  • Click on Upload Image in the top right corner and select an image

You can add an unlimited number of images per product. The main image will be the one that is first in line. You can drag and drop images to change the order. Hover over a specific image and click the trash can to delete an unwanted image.

Uploading product images

Step 8: Add image descriptions

You can also add descriptions of specific product features to your images. Hover over the image and click on the pencil to edit the information.

Editing product images

How to export products

The CSV export tool allows you to export products from your dashboard to a CSV file. To export products go to Catalog , then on the main Products page click the three dots at the top of the page. You can export the whole product base or select and export specific products to a CSV file. The CSV file will be sent via email.

How to manage metadata in the product setup page

You can add private and public metadata for each product in the product setup page. Use the button Add Field to add a new metadata field.

To learn more about object metadata, see the Developer's Guide.

How to delete or edit products

Click on an existing product from the main list. You will be redirected to the same interface as for adding products.

Delete

Click Delete at the bottom of the page to permanently remove a product.

Edit

To edit product details, click any field and start making changes. The Save button in the footer will activate as soon as you have made amendments that need to be saved before exiting the page.

Save it for later

Do not remove a product if you just want to temporarily take it away from your inventory. In that case, just select the Hidden option in the Visibility card, as described above.

How to use the variant creator

When creating a new product, your attributes are assigned automatically once you select a Product Type. Based on these attributes, you can create variants of your product.

Click the Create Variants button in the Variants card to open the 3-step variant creator.

In the Select Values tab, make your selection from the previously set up values assigned to each attribute. Once you make your choice, Saleor cross-matches selected values of attributes and creates appropriate product variants.

Choose the variants of the product that you will stock and click Next to move to the Price and SKU tab.

Product Variant Creator

Price Section

Specify how you want your prices to be applied to each variant:

  • Apply single price to all SKUs - All attribute values of this product to have the same price.
  • Apply unique prices by attribute to each SKU - Search attribute has a different value differently which you must manually assign.

Product Variant Creator

Stock section

How you want to manage your stock:

  • Apply single stock to all SKUs - Select this option if you have the same amount of each product.
  • Apply unique stock by attribute to each SKU - Use this option if your stock levels are different for each variant.

Click Next to progress to the Summary tab containing an overview of the variants you’ve just created. You can still edit inventory, price and SKU.

Product Variant Creator

Once saved, you can edit variants through the same steps as described above and then save changes.

Checking inventory

In this example, you can see five types of t-shirt. Four have enough stock to cover future orders. The S size has a red mark and is unavailable. When we click on the product, we can see in the product variant details that the product is unavailable because there are fourteen items in stock (“Inventory”) and they have been ordered by a customer (“Allocated”).

Checking inventory

Managing variants of a product

Click on a specific product from the variants list to edit the size, images, pricing, shipping and inventory.

To add a new variant, click the Add variant button in the variants list. While creating a new variant, you need to fill in all information required and assign to a specific warehouse by clicking the + button in the Inventory section.

Editing product variants

You can edit the cost and sale price of an item in the Pricing card.

When you receive new stock, enter the amount in the Quantity Available field in the Inventory section to keep up to date and avoid false out-of-stock messages. Make sure to save your changes before exiting.

To track inventory, you need to enable the Track Inventory checkbox.

You can repeat this process for all sizes or types of the same product by clicking the Variants card on the left side. Each variant has a specific SKU code (Stock Keep Unit) which is unique to specific variants.

How to manage metadata in the variants page

Once the product is created, you can add private and public metadata for each variant in the variants page. Use the button Add Field to add a new metadata field.

To learn more about object metadata, see the Developer's Guide.

How to manage attributes

When selecting a product record from the main list, click the Edit Attributes label in the top corner of the Variants card to add or change product attributes and variants. For example, a top or t-shirt will have a product attribute such as the material it is made from, and a variant attribute of the sizes or colors in which it is available.

Editing product attributes

In the Product Attributes card, click the Assign Attribute button. A pop-up will appear where you can select new attributes. Click the Assign Attribute button to confirm and exit.

Adding attribute

You can edit existing attributes and variants in the same way, and delete them by clicking the trash can.