Product attributes define how your products are uploaded, displayed, matched, filtered, and used across PriceShape features such as pricing strategies, widgets, and indexes.
Please note: Some predefined default attributes are required for core calculations, product matching, and validations in PriceShape. Custom attributes provide additional flexibility but cannot replace default attributes for these functions.
How attributes are used in PriceShape
When your product data source is uploaded to PriceShape using one of the supported upload methods (HTTP(S), FTP/SFTP, or Google Sheets). During the mapping step, each field in your feed is mapped to a default or custom attribute.
Correct mapping ensures:
Products are displayed correctly in the product list
Products can be matched with vendors
Prices, margins, and indexes are calculated correctly
Products can be filtered and grouped in strategies and dashboards
Attribute importance levels
Each default attribute belongs to one of the following importance levels:
Needed: Required for PriceShape’s core functionality
Important: Strongly recommended for pricing strategies and comparisons
Nice to have: Useful for filtering, segmentation, and reporting
Non-required: Optional attributes for additional customization
Attribute category types
Each attribute belongs to a category type, which describes what the attribute is used for in PriceShape:
Price attributes: Used for price calculations, comparisons, margins, and pricing strategies
Group attributes: Used to group, segment, and bundle products (for example, by brand, category, or variants)
ID attributes: Used to uniquely identify products and validate matches
Other attributes: Used for product display, availability, links, VAT, and additional configuration
Default attribute overview
The sections below list all default attributes used in PriceShape. Attributes are grouped by importance level and further divided by attribute category type to make it easier to understand what must be mapped first and how each attribute is used.
Needed Attributes (Required)
These attributes must be mapped for PriceShape to function correctly.
ID Attributes
GTIN / EAN / UPC / ISBN
The primary identifier for products in PriceShape.
Used to validate and assign matches
Must be mapped to the default GTIN attribute
If the GTIN is mapped to a custom attribute, matches will not be added to the product list.
Group Attributes
Brand
Represents the brand associated with the product.
Used for brand-based strategies
Required for searching and validating new matches
Must be mapped to the default Brand attribute
Other Attributes
Product Title
The product name or title.
Used to identify products in the product list
Used when searching for new matches
Must be mapped to the default Product Title attribute
ID Attributes
Item Group ID (If you want to bundle your account)
Used to bundle product variants (for example, different sizes or colors) into a single product group.
Required for feed bundling and when combining multiple feeds
Allows PriceShape to treat variants as one unified product
Must be mapped to the default Item Group ID attribute
Important Attributes (Strongly Recommended)
These attributes are not strictly required but are essential for pricing strategies and meaningful comparisons.
Price Attributes
Price
Represents the current product price.
Used for price comparisons, index values, and profit calculations
Must be mapped to the default Price attribute
Sales Price
Represents a discounted or promotional price.
Becomes the active price when mapped
Used in strategy calculations and displayed on the product card
Must be mapped to the default Sales Price attribute
Cost Price
Represents the cost of the product.
Required when using pricing strategies based on profit or margin
Used to calculate gross profit and gross margin
Must be mapped to the default Cost attribute
Note: Cost price is often provided without VAT. Always verify this when mapping your feed.
Nice to Have Attributes
These attributes improve filtering, segmentation, reporting, and product overview.
Price Attributes
Suggested Retail Price (SRP)
Represents the recommended retail price.
Can be used in pricing strategies
Shipping Price
Represents the shipping cost of the product.
Group Attributes
Product Type
Represents the category or type of the product (for example, Sneakers or Laptops).
Useful for category-based strategies and segmentation
Tags
Labels used to describe or group products, such as bestseller, seasonal, or campaign.
Values can be comma-separated
Used for filtering and strategy targeting
ID Attributes
SKU
Internal stock keeping unit from your inventory or ERP system.
MPN
Manufacturer Part Number.
ID
A general internal product identifier.
Other Attributes
Stock Quantity
Shows how many units of a product are currently in stock.
Used to calculate inventory value
Must be mapped to the default Stock Quantity attribute to be included in calculations
Image Link
URL to the product’s main image.
Enables product visuals in the product list
Must be mapped to the default Product Image attribute
Product Link
Direct URL to the product page on your website.
Allows quick access to the live product from PriceShape
Non-Required Attributes (Optional)
These attributes are optional and mainly used for display or additional configuration.
Other Attributes
Stock Status
Indicates whether a product is in stock or out of stock.
Accepted values include:
In Stock / in_stock
Out of Stock / out_of_stock
Unrecognized values are shown as Unknown.
Must be mapped to the default Stock Status attribute to be displayed on the product card
VAT
Defines the VAT rate for a product.
A default VAT rate is applied based on the selected country during feed setup
Product-level VAT overrides the default VAT
Accepted formats: numeric (7) or percentage (7%)
Must be mapped to the default VAT attribute
Custom Attributes
In addition to default attributes, you can create and add custom attributes when your data does not fit an existing default attribute.
Custom attribute categories
ID
Price
Group
Text
Other
Limits
Up to 25 Group attributes
Up to 10 of each other's custom attribute types
Custom attributes can be used in:
Strategies
Filters
Reporting
Core calculations, matching, and validations always rely on default attributes.