Crossupsell
Cross-sell and upsell recommendation entity representing product relationship rules.
Defines recommendation relationships between products or product clusters to drive sales optimization. Each recommendation specifies a source (trigger) and target (suggested) product or cluster, along with the relationship type and optional categorization.
Supports both individual product recommendations and scalable cluster-based recommendations for comprehensive product relationship management.
type Crossupsell {
id: String!
createdAt: DateTime!
lastModifiedAt: DateTime!
type: CrossupsellType!
subType: String
productTo(
hidden: Boolean
): IBaseProduct
productFrom(
hidden: Boolean
): IBaseProduct
clusterTo(
hidden: Boolean
): IBaseProduct
clusterFrom(
hidden: Boolean
): IBaseProduct
}
Fields
Crossupsell.id
● String!
non-null scalar
Unique identifier for the cross-sell or upsell recommendation.
This UUID serves as the primary key for the recommendation and is automatically generated when a new recommendation is created. Used for referencing, updating, or deleting specific recommendations.
Crossupsell.createdAt
● DateTime!
non-null scalar
Timestamp when the recommendation was originally created.
Automatically set when a new cross-sell or upsell recommendation is first saved to the system. Used for tracking recommendation age, analyzing creation patterns, and filtering by creation timeframes.
Crossupsell.lastModifiedAt
● DateTime!
non-null scalar
Timestamp when the recommendation was last modified.
Automatically updated whenever any field of the recommendation is changed. Used for tracking recent updates, cache invalidation, and analyzing recommendation maintenance activity.
Crossupsell.type
● CrossupsellType!
non-null enum
The type of cross-sell or upsell recommendation relationship.
Defines the nature of the relationship between source and target products:
- ACCESSORIES: Complementary products that enhance the main product
- ALTERNATIVES: Substitute products for comparison or when main product unavailable
- OPTIONS: Upgrades, variations, or enhanced versions of the main product
- PARTS: Replacement components, spare parts, or consumables
- RELATED: Products commonly purchased together with the main product
Crossupsell.subType
● String
scalar
Custom subtype classification for more granular categorization within the main recommendation type.
Provides additional context for recommendation logic and presentation. Examples include:
- For ALTERNATIVES: "CHEAPER_ALTERNATIVE", "PREMIUM_ALTERNATIVE"
- For ACCESSORIES: "ESSENTIAL", "OPTIONAL", "PREMIUM_ADDON"
- For OPTIONS: "SIZE_VARIANT", "COLOR_VARIANT", "FEATURE_UPGRADE"
Maximum length: 64 characters
Crossupsell.productTo
● IBaseProduct
interface
Target product being recommended in the cross-upsell relationship.
Returns the complete product information for the product being suggested to customers. This is the product that will be recommended when customers view or purchase the source product.
Crossupsell.productTo.hidden
● Boolean
scalar
Include hidden products in the lookup.
When true, includes products marked as hidden in the search. When false or not specified, only returns visible products.
Crossupsell.productFrom
● IBaseProduct
interface
Source product that triggers the cross-upsell recommendation.
Returns the complete product information for the product that initiates this recommendation. When customers view or purchase this product, the target product will be suggested.
Crossupsell.productFrom.hidden
● Boolean
scalar
Include hidden products in the lookup.
When true, includes products marked as hidden in the search. When false or not specified, only returns visible products.
Crossupsell.clusterTo
● IBaseProduct
interface
Target cluster being recommended in the cross-upsell relationship.
Returns the complete cluster information for the cluster being suggested to customers. Products from this cluster will be recommended when customers view or purchase from the source cluster.
Crossupsell.clusterTo.hidden
● Boolean
scalar
Include hidden clusters in the lookup.
When true, includes clusters marked as hidden in the search. When false or not specified, only returns visible clusters.
Crossupsell.clusterFrom
● IBaseProduct
interface
Source cluster that triggers the cross-upsell recommendation.
Returns the complete cluster information for the cluster that initiates this recommendation. When customers view or purchase from this cluster, the target cluster will be suggested.
Crossupsell.clusterFrom.hidden
● Boolean
scalar
Include hidden clusters in the lookup.
When true, includes clusters marked as hidden in the search. When false or not specified, only returns visible clusters.
Returned By
crossupsell
query ● crossupsellCreate
mutation ● crossupsellUpdate
mutation
Member Of
CrossupsellsResponse
object