Skip to main content
All CollectionsPriceShape Attributes & Data cycle
Attributes in PriceShape
Attributes in PriceShape

Here you'll find a full description of all available mappings to PriceShape

Steffan H. Mathiasen avatar
Written by Steffan H. Mathiasen
Updated over a week ago

When we work with your product feeds we simply draw lines between your attributes and PriceShape's attributes it also means that we don't require specific naming conventions when importing your data. Though we do have some limitations within our setup and some recommendations for attributes to include in your PriceShape product feed.

Unique identifier attributes

Price attributes

Basic product data

Product quantity attributes

Other attributes

Unique identifier attributes

Unique identifiers are used as a database for your product data.

Link (Required)

  • Links are the unique product identifier in PriceShape, therefore one link = one product.

  • Use a unique URL for each product.

  • All historical data like competitor price history, matches, and indexes are stored on the links. New or deleted links will result in lost data.

  • Do you have dynamic links or need to swap the links, please reach out to PriceShape before you apply the changes.

  • Keep the value the same when updating your product data

Format

Usage in PriceShape

Required (When using XML.feeds)

Strongly recommended (When using google sheets feed) - We autogenerate links if these are not provided.
​
Your products landing page
​
​Syntax: Start with HTTP or HTTPS
​
​Example: http://www.example.com/priceshape#21

  • Navigates from your product to your product page

  • Unique product identifier


    ​

Item group id (Optional)

  • Item group id is the unique identifier in PriceShape, therefore one item group id = one product

  • Overrules attribute link as the identifier on products that have both

  • All historical data like competitor price history, matches, and indexes are stored on the item group id. New or deleted ids will result in lost data

  • Use a unique value for each group of variants

  • Use an item_group_id for a set of products that differ by one or more of the same attributes like color, size, gender, etc.

  • NB: PriceShape randomly chooses one of the bundled products as a "master product". Therefore data like availability, products in stock, and quantity can't be shown and analyzed on the product level

Format

Usage in PriceShape

Optional
​
​ID for a group of products that come in different versions (variants)
​
​Example: 1234Abcd

  • Unique product identifier

Price attributes

The price attributes cover the price settings options in PriceShape.

Price (Required)

  • The price attribute displays a given products price in the product list

  • For additional options to submit price-related information, see sale_price

Format

Usage in PriceShape

Required

Your product's price


​Syntax:

• Numerical (PriceShape reads the first two decimals, no rounding).
​
​• PriceShape accepts both EU and US thousand separators
​
​Example with currency: EUR 2000,95
​
​Example without currency: 2000,95
​

• Price Strategies
​
• Dynamic tags
​
• Domain summary
​
• Management ratios ex. gross profit
​

Cost price (strongly recommended)

Format

Usage in PriceShape

Strongly recommended
​
​Your product's cost price


​Syntax:
• Numerical (PriceShape reads the first two decimals, no rounding).
​
​• PriceShape accepts both EU and US thousand separators
​
​Example with currency: EUR 20,95
​
​Example without currency: 20,95
​

• Price Strategies
​
• Dynamic tags
​
• Management ratios ex. gross profit

Sale price (Recommended)

  • Overrules attribute price

  • Submit this attribute (sale_price) in addition to the price attribute is set as a non-sale price

  • When empty or deleted the attribute price is used

Format

Usage in PriceShape

Optional
​
​Your product's sale/promotion price price


​Syntax:
​• Numerical (PriceShape reads the first two decimals, no rounding).
​
• PriceShape accepts both EU and US thousand separators
​
​
​Example with currency: EUR 2000,95
​
​Example without currency: 2000,95
​

• Price Strategies
​
• Dynamic tags
​
• Domain summary
​
• Management ratios ex. gross profit
​
​
​

Suggested retail price (Recommended)

  • Can not be used as a product price (See price & sale_price)

Format

Usage in PriceShape

Optional
​
​Your suggested retail price


​Syntax:
• Numerical (PriceShape reads the first two decimals, no rounding).
​
• PriceShape accepts both EU and US thousand separators
​
​Example with currency: EUR 2000,95
​
​Example without currency: 2000,95

• Price Strategies
​
• Dynamic tags

Shipping price (Optional)

Format

Usage in PriceShape

Optional
​Your product's shipping price

Syntax:
• Numerical (PriceShape reads the first two decimals, no rounding).
​
• PriceShape accepts both EU and US thousand separators
​
​Example with currency: EUR 2000,95
​
Example without currency: 2000,95
​

• Dynamic tags

Basic product data

The basic product data covers general product identification values.

GTIN/EAN (Required)

  • PriceShape uses the GTIN number to search for new matches for your products

  • Providing the correct GTIN for a product will ensure the highest match rates

  • It's not possible to use other values than GTIN to search for new products

Format

Usage in PriceShape

Required
​
Your product’s Global Trade Item Number (GTIN)
​
​Syntax: Only numerical (Spaces and dashes do not work)
​
​Example: 3234567891234

• Scraping for new competitors
​
• Used to search for products within PriceShape

Title (Strongly recommended)

Format

Usage in PriceShape

Strongly recommended
​
​Your product's title
​
​Example: Chocolate-flavored marshmallows
​

• Displays the product title in the Product list

• Used to search for products in Price Shape

Brand (Strongly recommended)

Format

Usage in PriceShape

Strongly recommended
​
​Your product's brand name
​
​Example: PriceShape
​

• Price Strategies
​
• Dynamic tags
​
• Filters
​

Id (Strongly recommended)

Format

Usage in PriceShape

Optional
​
​Your product's article number
​
​Example: a-42130

• Used to search for products within PriceShape

SKU (Optional)

Optional
​
​Your product’s stock-keeping unit
​
​Example: 1041256

• Used to search for products within PriceShape

MPN (Optional)

Format

Usage in PriceShape

Optional
​
​Your product’s manufacturer part number
​
​Example: HB45d52

• Used to search for products within PriceShape

Product quantity attributes

The product quantity attributes cover all attributes which define the amount of a given product.

Availability (Recommended)

  • Does not synergize well with Item group ID

Format

Usage in PriceShape

Recommended
​Your product's stock status
​
​Syntax in stock: "in stock", "in_stock", or "y"'
​Syntax out of stock: "out of stock", "out_of_stock" or "n"

Syntax pre-order: "preorder"

• Dynamic tags
​
• Filters
​

Products in stock (Optional)

  • Does not synergize well with Item group ID

Format

Usage in PriceShape

Optional
​
​The number of products you have in stock
​
​Example: 20

• Dynamic tags

Quantity (Optional)

  • Does not synergize well with Item group ID

Format

Usage in PriceShape

Optional
​
​The quantity amount within one product
​
​Example: 24

• Used recalculate competitor prices
​
• Competitor prices multiply with the selected amount

Other attributes

Product Type(s) (Strongly recommended)

Format

Usage in PriceShape

Strongly recommended
​The product category that you define for your product
​
​example: Summer > Women > Dresses
​
​Syntax: Use uni-code as separators (&gt). If the syntax isn't fulfilled PriceShape only reads the last value.

• Price Strategies
​
• Dynamic tags
​
• Filters
​

Custom labels (Recommended)

Format

Usage in PriceShape

Recommended
​
​Labels that you assign to a product to help organize, bid, and report
​
​Example: Holyday

• Price Strategies
​
• Dynamic tags
​
• Filters
​

Image link (Strongly recommended)

Strongly recommended
​
​Image of your product
​
​Syntax: Start with http or https and use an accepted format: JPEG (.jpg/.jpeg), WebP (.webp), PNG (.png), non-animated GIF (.gif), BMP (.bmp), and TIFF (.tif/.tiff)
​
​Example: http://www.example.com/image1.jpg

• Displays the image of your product in the product list

Vat (Optional)

  • Can be changed in PriceShape on the entire assortment or product-level

Format

Usage in PriceShape

Optional
​
​Vat amount on your product
​
​Best practice: Use if there are different vat amounts in your assortment
​
​Example: 21% or 21
​
​

• Used to calculate management ratios ex. gross profit
​
• Default set to 25% - this can easily be changed

Description (Optional)

Optional
​
​Your product's description
​
​Example: Made from 100% organic cotton, this classic red men’s polo has a slim fit and a signature logo embroidered on the left chest.

• Not visible in PriceShape as default

Did this answer your question?