ShopStyle Feed Specifications

Request Demo

ShopStyle is a large fashion marketplace that drives over $1 billion in gross sales to over 1,400 merchants. ShopStyle also owns the  commerce engine behind ShopStyle Collective, a network of 14,000 bloggers who use it as an affiliate network

shopstyle

How to create a ShopStyle feed

 

You will need to fill out the information in this contact form to begin the process of setting up your store and feed with ShopStyle http://retailers.shopstyle.com/.

Required ShopStyle Fields with description of each field

 

Field NameDescription
catalogThis is a grouping of different products in ShopStyle and must include:
1. Timestamp – The time at which the feed was generated, as an ISO 8601 timestamp.
2. Xmlns – The XML namespace for the document. Should always be “http://www.shopstyle.com/schemas/shopstyle-catalog”,
3. Xmlns:xsi- The XML Schema info namespace declaration
4. xsi:schemaLocation- The location of the schema
productThis is the central object of a ShopStyle retailer feed. Each product described by the feed is represented as a product element.

programname

The name of the retailer/program. Must be consistent throughout the feed, and unique to the retailer.

lastmodifieddate

This is the date of last modification of the product, expressed as an XML Date object, in the format “YYYY-MM-DD”, with optional timezone offsets.

productid

he unique and constant ID for the product. This may be a style ID or a SKU, but must be unique to the feed and should never change.

name

The name of the product.

brand

The name of the product’s brand.

description

A textual description of the product. This is a CDATA block, and a limited subset of HTML markup is allowed

currency

The currency denomination of prices. Acceptable values are USD, EUR, JPY, GBP, AUD, CAD and should match feed’s locale (see Introduction). It is expected that currency is consistent throughout the feed.

price

The regular price of the product.

producturl

The direct URL for the purchase page of a product.
imageurlThe direct URL for the main, full-size product image.
categoryCategory info for the product. Multiple category elements are allowed. Gender must be included in at least one of the categories. Local-language gender references are fine. The exception for this requirement is the case where a retailer’s entire line is for a single gender. However, it’s highly recommended that gender always be provided. All available product categories should be included, in multiple category items. Care should be taken to not include non-relevant categories, as this can result in miscategorized or uncategorized items on the ShopStyle site.

 

Optional Fields with description of each field

 

Field NameDescription
lastmodifiedtimeThis is the date of last modification of the product, expressed as an XML Time object, in the format “HH:MM:SS”, with optional timezone offsets.
parentidToken field to link related products (interpretation is retailer-specific)
salepriceThe reduced price of a product which is on sale. Expressed in the same currency as price. For products which are on sale, both price and saleprice should be provided. This will allow the ShopStyle system to indicate that an item is on sale, include the item in sale alerts, etc.

saleprice must always be lower than price; products for which saleprice is greater than price will be rejected.

saleprice has the same formatting requirements as price.

It is invalid to include a saleprice without a price in a product.

retailpriceThe “usual retail” price, or MSRP. Used for comparison purposes. Expressed in the same currency as price.
rentalpriceFor products which are available for rent, the price of the rental. Expressed in the same currency as price.
sizeAn available size for the product. Multiple sizes are allowed. The contents of size are flexible, and most common size designations in supported locales are allowed. The value must conform to the same formatting restrictions as name, productid, programname, etc.

Omission of size will mean that sizes are not indicated on the ShopStyle site.

colorAn available color for the product. Multiple colors are allowed. Each color must at least contain a name.

The color name can be a hex RGB value, e.g. “D0D0D0″

The imageurl subelement is optional. If it is provided, then hovering over the color name or swatch will cause the product image to switch to the color-specific version for the duration of the hover. If it is not provided, the product image will not change as a user’s pointer hovers over color.

The swatch subelement is optional. If it is provided, it will be displayed along with the list of colors available for a product. If it is not provided, an attempt will be made to generate a solid-color swatch based upon the color name.

At most one color may have an imageurl that matches the product’s imageurl. No swatchurl may match a product’s imageurl.

instockA representation of a size/color combination of a product that is available for purchase. While product size and color are optional elements, the presence of either determines whether it is required in any instock elements. For example:

If a product has both color and size information, then a valid instock element will contain both Color and Size subelements. Omission of either is invalid.

If a product has only a color element, then only the Color subelement is valid within instock.

If a product has only a size element, then only the Size subelement is valid within instock.

If a product has neither color nor size elements, then its presence in the feed deems it available, and no instock is required.

If a product has either color or size elements, or both, then an instock element is required for each in stock combination; omission of all instock information will be interpreted as all color/size combinations of the product being out of stock.

 

What formats does ShopStyle accept (CSV, XML, API, etc)

 

ShopStyle accepts files in an XML format for their feeds.

 

How to send your ShopStyle feed (FTP, URL, etc)

 

ShopStyle can receive feeds in several different ways: Http Pull, FTP Pull and FTP Upload.

 

When providing ShopStyle with a HTTP URL you must include the following information: Full URL including protocol (http or https), hostname, and URI. You will also need to include the username and password to use, if any.

 

When providing ShopStyle with an FTP location from which to pull the product feed, please include the following:

  • The fully-qualified hostname for the FTP server (e.g. “ftp.myshop.com”).
  • The path to the feed file to pull.
  • Username and password ShopStyle should use.
  • The protocol being used (FTP / SFTP)

 

You may also choose to upload their product feed to ShopStyle’s FTP server (ftp.shopstyle.com). In this case, ShopStyle will provide you with account credentials and a filename to use when uploading the feed. ShopStyle refreshes product information for each retailer at least once per day, and it’s expected that a retailer product feed is refreshed at least daily.

 

We work with businesses everyday and know that you want your products available everywhere. So what are the options? You can try spreadsheets, but you have to start over and re-import every time you need to update pricing, inventory levels, or products (sometimes multiple times per day). You then have to re-optimize using best practices or you send junk (which is nearly impossible when you have a lot of SKUs), or you could try using some of the off the shelf “do-it-yourself” product feed platforms, but many are grossly inadequate, too complicated, difficult to use. Others are too simple and can’t properly clean your product feeds, requiring you to put in countless hours of manual work. Others are too pricey costing thousands each month.

Many business owners decide that it would be better to let us help them get their feeds working properly. If you would like to learn a bit more about the 100+ other channels like ShopStyle that we can get your product set into then please contact us with the form below and learn a bit more about how we can help you maximize your time and expand your sales channels.

 

Need Help With ShopStyle Feed Management?