Links

Creating a New Product

To create a new product for your store, go into the Admin Interface, click the “Products” tab, and click the “New Product” button.
New Product Entry Form
The three mandatory fields (“Name”, “Master Price”, and “Shipping Categories”) are denoted with an asterisk (*) next to the label. You can leave SKU blank. If you don’t add a value for “Available On” the product will not be shown in your store.
Prototypes are a more complex topic and are covered in their own guide.
After you click the “Create” button, the Spree application brings you to a more detailed product entry page, where you can input more information about your new product.§
Product Edit Form
  • Name - This field will either be blank, or the same as what you entered on the initial page. You can change this field whenever you like.
  • Slug/Permalink - The permalink is automatically created by the application for you when the product is first saved. It is based on the product’s name. This is what is appended to the end of a URL when someone visits the page for a particular product. You can change the permalink, but should exercise extreme caution in doing so to avoid naming collisions with other products in your database.
  • Description - This is where you will provide a detailed description of the product and its features. The application gives you plenty of room to be thorough.
  • Master Price - For now, just think of the Master Price as the price you charge someone to buy the item. Later in this guide, you will learn more about variants and how they impact a product’s actual price.
  • Compare at Price - Allows you to set up a visible discount on the product detail page. It will be visible as a strikethrough price
  • Cost Price - What the item costs you, the seller, to purchase or produce.
  • Cost Currency - It may be that the currency used when you purchased the product is not the same as that which you use in your store. Spree makes these conversions for you. Just enter the code for the currency used in acquiring your inventory.
  • Available On - This field will either be blank or the same as what you entered on the initial page. You can change this field whenever you like.
  • Discontinue on - This option allows to set a date from which the product will no longer be available to purchase; however, you can always change the date and make the product available again.
  • Promotable checkbox - This checkbox gives the possibility to include or exclude the product from any discounts
  • Master SKU - This field will either be blank, or the same as what you entered on the initial page. You can change this field whenever you like.
  • Weight - The product’s weight in ounces. May be used to calculate shipping cost.
  • Height - The product’s height in inches. May be used to calculate shipping cost.
  • Width - The product’s width in inches. May be used to calculate shipping cost.
  • Depth - The product’s depth or breadth in inches. May be used to calculate shipping cost.
  • Shipping Categories - You will learn about setting up Shipping Categories in the Shipping Categories.
  • Tax Category - You will learn about setting up Tax Categories in the Taxes Guide.
  • Taxons - Taxons are basically like categories. You will learn more about them in the Taxonomies Guide.
  • Option Types - You can select any number of Options to associate your new product with. You’ll learn more about Options in the Options Guide.
  • Meta Title - The name of the product site that is visible in the browser navigation bar. We highly recommended filling out Meta Title/Keywords/Description for each product since it does improve SEO and will index the site name in Google Search.
  • Meta Keywords - These words are appended to the website’s keywords you established in the Store Settings and can help improve your site’s search engine ratings, bringing you more web traffic. They should be words that are key to your new product.
  • Meta Description - The summary that someone sees when your product’s page is returned in a web search. It should be descriptive but not overly verbose.

Images

A store without products images would be pretty boring - and probably not garner a lot of sales. It would be very time-consuming to have to upload, crop, resize, and associate several photos to each product, if you had to do so manually. Luckily, Spree makes maintaining images of your products quick and painless.
Just click the “Images” link under “Product Details” on the right-hand side of the screen. Any images that you may have already uploaded will be previewed for you. To add a new image for your product then click the “New Image” button.
New Product Image Form
Select the Image file and enter the Alternative Text for the image. Alternative Text is what appears when someone has their browser’s image-rendering turned off, as with certain types of screen readers.
You have the option to associate a photo only with a particular “Variant” (again, more on Variants later in this guide), or with all of the product’s Variants.
When you click “Update”, not only is the product photo uploaded, it is automatically resized and cropped to fit your store’s requirements. It is associated with the correct versions of your product.
Suppose that you sell drink tumblers in your store. All of the tumblers are made by the same manufacturer and have the same basic product specifications -such as materials used and machine washability rating but your inventory includes several options:
  • Size - You stock both medium and large tumblers
  • Decorative Wrap - Your tumblers come with the option of several kinds of decorative plastic wraps: stars, owls, pink paisley, purple paisley, or skulls.
  • Lid Color - The tumblers also come with an assortment of lids to match the decorative wrap - the star tumblers have blue lids, the owls have orange lids, the pink paisley have pink lids, the purple paisley have white lids, and the skulls can be purchased with white or black lids.
Given this inventory, you will need to create a Drink Tumbler Product, with three Option Types, the corresponding Option Values, and twelve Variants:
Size
Wrap
Lid Color
Large
Stars
Blue
Small
Stars
Blue
Large
Owls
Orange
Small
Owls
Orange
Large
Pink Paisley
Pink
Small
Pink Paisley
Pink
Large
Purple Paisley
White
Small
Purple Paisley
White
Large
Skulls
White
Large
Skulls
Black
Small
Skulls
White
Small
Skulls
Black
The Option Types you would create for this inventory are - Size, Wrap, and Lid Color - with the corresponding Option Values below.
Option Type
Option Values
Size
Large, Small
Wrap
Stars, Owls, Pink Paisley, Purple Paisley, Skulls
Lid Color
Blue, Orange, Pink, White, Black
Read the Product Options Guide for directions on creating Option Types and Option Values. You must establish your Option Types and Option Values before you can set up your Variants. Don’t forget to associate the Option Types with the tumbler product so they’ll be available to you when you make your Variants.
Now that you have set up the appropriate options for your Product’s Variants and associated those options with the product, you can create the Variants themselves.
Let’s create the large, star-wrapped, blue-lidded tumbler Variant as an example. You can then use the same approach to creating all of the other Variants we mentioned earlier.
On your tumbler product edit page, click the “Variants” link then click the “New Variant” button.
New Product Variant
Select the appropriate values for the Option Types. As you can see, you also have the choice to enter values for this particular Variant that may be different from what you input on the Product’s main page. Let’s raise the price of our Variant to $20. Click the “Create” button.
Variants List
You can set as many individual product properties as you like. These include things like the item’s country of manufacture, material(s) used, design style, etc. Typically, these are characteristics that do not change across variants of a product.
You can read much more in-depth information about this feature in the Product Properties Guide.
As of Spree version 2.0, you now have much more granular control over how inventory is tracked through your store. You will learn more about stock locations in the Stock Locations Guide, but for now, it’s enough to understand that you enter the number of each product variant that you have at each of your individual stock locations.
Let’s assume that you have two stock locations - your main New York warehouse and your satellite Detroit warehouse. Refer to the instructions on creating stock locations in the Stock Locations Guide to add your warehouses.
Now, go back to the Tumblers product page, and click the “Stock Management” link.
Stock Management Page
For this guide, let’s say we want to say that we have 7 of our tumbler variant in the New York warehouse, and 3 in Detroit. To accomplish this, change the quantity to 7, select “New York Warehouse” from the “Stock Location” drop-down list, and select “large-blue-stars” from the “Variant” drop-down list. Click the “Add Stock button”.
The “Stock Location Info” table will update, showing you that there are 7 of these items in the New York warehouse. Repeat these steps, adding 3 tumblers from the Detroit warehouse.
Stock Location Info
Stock Location Info
Your Stock Location Info table should now look like the one pictured above.
“Backorderable” may or may not be checked for your individual Stock Locations, depending on how you configured them. Each Stock Location has defaults for this value, but you can change it on a variant-by-variant basis in this dialog.
You should be sure to read the Stock Locations and Stock Movements guides for further information on managing your store’s inventory.