DB 1084 Custom Relationships key concepts

docs/partials/pxm/custom-relationships/crcharacteristics.mdx

@@ -0,0 +1,9 @@
+Custom relationships have the following characteristics:
+
+- Custom relationships are bidirectional. For example, if Product A is linked to Product B, then Product B is automatically linked to Product A as well. If a customer views Product A and there's a bidirectional relationship with Product B, Product B will be suggested or related to Product A, and vice versa. This helps in improving product discoverability and ensuring consistent user experiences across your storefront.
+- Each relationship that you define must have a unique slug.
+- Each relationship slug is prefixed with `CRP_` (custom relationship product). Product Experience Manager adds this automatically if you do not provide it when creating the custom relationship.
+- A product can be included in up to 5 relationships.
+- 2000 products can be related to a product per custom relationship.
+
+

docs/partials/pxm/custom-relationships/croverview.mdx

@@ -0,0 +1,26 @@
+You can create custom relationships between products in Product Experience Manager, allowing you to link or associate your products in certain ways based on criteria of your choosing. These relationships help improve user experience, boost sales, and enhance product discoverability. You can create custom relationships in both the [Product Experience Manager API](/docs/api/pxm/products/product-experience-manager-introduction) and [Commerce Manager](/ui).
+
+### Parent/Child Groupings
+
+You can create parent/child relationships between products using custom relationships instead of using variations. Using custom relationships instead of variations has several benefits.
+
+- You can use existing products. You do not have to create new products to get started. Simply, create a custom relationship and start relating products.
+- If your catalog's source of truth is maintained externally, outside of Elastic Path, you do not need to make changes to the way your product data is generated or managed. The data can flow into Elastic Path and, once the product data reaches Elastic Path, you can immediately relate products using custom relationships, without having to evaluate, change and build variations and options data.
+- Custom relationships allow more flexible and complex associations. Large numbers of variations are difficult to maintain and variations are often limited to predefined attributes like size or color, which can restrict how products are related.
+
+### Product Groupings
+
+There are some common custom relationship types.
+
+- Cross-selling: Suggesting related products that customers who might want to buy in addition to the product they are viewing. For example, if a customer is looking at laptops, you might suggest memory cards, laptop bags, external mouse, and so on. Cross-selling encourages customers to purchase complementary items.
+- Up-selling or alternative products: Suggesting products that serve the same function as the product a customer is viewing, but may be different brands, prices, better specifications, or have additional features. This ensures customers find the best product for their needs and may increase the order value by guiding customers to more premium options.
+- Custom collections: Create custom collections of products that share a theme, like **Back to School** or **Summer Holiday Fashion**. These guide customers to multiple products that fit a specific purpose or occasion.
+
+### Custom Relationships in Catalog Releases
+
+Once you have created your custom relationships and attached and associated your products, these relationships are automatically available when you publish your catalogs. You can then program your storefront to dynamically display the custom relationships.
+
+### Custom Relationships in Organizations
+
+You can use custom relationships in Organizations. For more information, see Organization Custom Relationships.
+

guides/key-concepts/product-experience-manager/products/custom-relationships/_category_.json

@@ -0,0 +1,5 @@
+{
+  "position": 31,
+  "label": "Custom Relationships",
+  "collapsible": true
+}

guides/key-concepts/product-experience-manager/products/custom-relationships/characteristics.mdx

@@ -0,0 +1,10 @@
+---
+title: Custom Relationship Characteristics
+nav_label: Custom Relationship Characteristics
+sidebar_position: 10
+---
+
+import CrCharacteristics from "/docs/partials/pxm/custom-relationships/crcharacteristics.mdx";
+
+<CrCharacteristics></CrCharacteristics>
+

guides/key-concepts/product-experience-manager/products/custom-relationships/overview.mdx

@@ -0,0 +1,10 @@
+---
+title: Overview
+nav_label: Overview
+sidebar_position: 5
+---
+
+import CrOverview from "/docs/partials/pxm/custom-relationships/croverview.mdx";
+
+<CrOverview></CrOverview>
+