The data model
Build a strong foundation for your product data
Setting up a strong data model is the most important step before entering data into Bluestone PIM. By defining how your products, attributes, and relationships interact from day one, you prevent costly rework, improve data accuracy, and lay the groundwork for automation.
Note: To help you build with confidence, the Bluestone PIM team offers dedicated workshops to help map out your structure. Reach out to your contact person to learn more.
Contexts Catalogs and Categories Attributes
GUID Products Relations Assets
Contexts
In Bluestone PIM, contexts are a feature that enables businesses to manage product information for different sales channels or markets. A context is a specific view of product information customized for a specific channel or market.
In Bluestone PIM, Contexts allow you to tailor product information for different sales channels, regions, or target markets from a single product record - without duplicating products. A context provides a channel-specific view of your data, letting you customize descriptions, attributes, or media for that particular audience.
Note: By default, Bluestone PIM includes one base context. You can add as many additional contexts as your business needs, and each context maintains its own independent publish state.
Catalogs and Categories
Catalogs and categories provide the structural framework for organizing, enriching, and navigating your product information in Bluestone PIM. You can build multiple catalogs tailored to different channels, markets, or brands, and configure multi-level category trees that match your business model.
Key capabilities:
-
Flexible hierarchies: Build multi-level category structures tailored to your catalog depth.
-
Intuitive arrangement: Reorder categories and sort products within any level using drag-and-drop.
-
Category-level enrichment: Assign Category-Level Attributes (CLAs) and attach digital assets directly to category nodes. Please see Category Level Attributes (CLA) on how to work with CLAs.
-
Governance and security: Apply access policies to control who can view or modify specific catalogs and products.
Please see Create and manage catalogs and categories for more information.
Attributes
In Bluestone PIM, attributes are data fields used to store and manage information about an entity (e.g. a product or an asset).
Please see Create, edit or remove attributes for details on how to manage attribute definitions. Refer to the Attributes chapter in the Product details panel article for details on how to manage product attributes.
GUID
A Globally Unique Identifier (GUID) is an automatically generated, 128-bit identifier assigned to every product created in Bluestone PIM. It serves as the primary system-level key to reference and manage products throughout their lifecycle.
Key benefits
- Guaranteed Uniqueness: Because GUIDs are globally unique, no two records in Bluestone PIM will ever share the same identifier, eliminating collision risks across catalogs.
- Reliable System Integration: GUIDs provide a stable, persistent reference when syncing product data with ERPs, e-commerce platforms, and external applications, ensuring data remains linked accurately even if product names or SKUs change.
- High-Volume Scalability: GUIDs can be generated independently without centralized counters or sequence bottlenecks, allowing your catalog to scale to millions of products without performance degradation.
Products
Products form the core foundation of your data model. To accommodate different inventory structures - from standalone items and multi-level variations to packaged kits - Bluestone PIM categorizes your catalog into several distinct product types:
-
Single
A standalone product with unique attributes and data. Single products exist outside the product hierarchy, but can be included as an item within a Bundle. -
Variant
A distinct version of a product, such as a specific color, size, or material. Every Variant belongs to exactly one Variant group and inherits its shared attributes. -
Variant group
Contains one or more Variants and manages shared data, with configurable settings per attribute to control how data is handled across member variants. A Variant group can exist independently or belong to a Family, and can also be included in a Bundle. Learn more about VLAs here. -
Family
An optional top level of the product hierarchy (Family → Group → Variant). A Family organizes one or more Variant groups under a shared umbrella and has no parent of its own. Learn more about Product families here. -
Bundle
A packaged set of products sold together as a single commercial unit (such as a computer and a monitor). Bundles exist outside the product hierarchy and cannot contain other bundles. Products within a bundle include a quantity attribute, which defaults to 1. Learn more about working with Bundles.
Please see Create new products for more information.
Relations
Product relations connect related items across your catalog to support cross-selling, up-selling, and complementary merchandising. Bluestone PIM supports two relation types based on direction:
-
One-way (unidirectional)
The link applies in only one direction. For example, a digital camera links to an SD memory card as a recommended accessory, but the memory card does not link back to that specific camera model. -
Two-way (bidirectional)
The link is reciprocal. For example, a wireless keyboard and a matching ergonomic mouse from the same product line automatically link to each other as complementary items.
To learn more, see Relations management on how to create relation definitions, and Add product relations on how to link products together.
Assets
In the Bluestone PIM data model, digital media files - such as images, videos, and PDF documents - are managed as independent entities within a centralized library. The Assets module provides a comprehensive overview of these files, giving you the tools to efficiently upload, tag, and organize your media before linking them to products or categories.
Please see Add and manage assets and Upload asset to DAM on how to upload assets to the mediabank. Learn how to work with assets in Assets overview.