menu
Oro Documentation: Find everything you need to use and develop your OroCommerce, OroCRM, and OroPlatform application
    Result in:
    close
    • Back to Oro Inc
    • Users
      • Solution ArchitectureLearn about the OroCommerce architecture, integration points, and the infrastructure to implement it.
      • Concept GuidesGet contextual references to detailed feature descriptions based on your business use case.
      • Back-OfficeExplore the key features and learn to automate workflows, create reporting and much more.
      • Commerce StorefrontIntroduction to OroCommerce default storefront navigation, interaction, and browsing.
      • IntegrationsExplore OroCommerce's pre-built and custom integration options.
      • GlossaryNavigate OroCommerce terms easily with our comprehensive glossary guide.
      Up for a challenge? Validate your skills and earn the Oro Certificate!
      • Learn More
    • Developers
      • Backend Developer GuideComprehensive documentation on installing, customizing, and maintaining Oro applications efficiently.
      • Frontend Developer GuideLearn to efficiently customize Oro apps appearance both on the Storefront and in the Back-office.
      • Oro Bundles & ComponentsExplore Oro Config Component and core bundle implementation for non-standard customizations.
      • Web Services API GuideIntegrate Oro functionality into third-party systems with REST API guide.
      • Community GuideLearn about the best ways to contribute to Oro applications, and engage with the Oro community.
      Up for a challenge? Validate your skills and earn the Oro Certificate!
      • Learn More
    • Cloud Administrators
      • ArchitectureUncover OroCloud's architecture with illustrative diagrams for deeper understanding.
      • Environment TypesUnderstand OroCommerce environment types for tailored deployment options and configurations.
      • SecurityDiscover OroCloud network diagram and Oro's comprehensive security protocols.
      • MonitoringEnsure service continuity and proactive resource management with OroCloud monitoring tools.
      • OnboardingStreamline your Oro application deployment with our comprehensive onboarding process guide.
      • VPN ConnectionLearn how to connect OroCloud VPN across different operating systems.
      • MaintenanceExplore the tools to manage maintenance tasks within your OroCloud environment.
      • SupportDiscover Oro's support process for Oro authorized partners and Enterprise customers.
      Up for a challenge? Validate your skills and earn the Oro Certificate!
      • Learn More
    • OroCommerce
    • OroHive
    • Documentation >
    • Users >
    • Back-Office >
    • Manage System Settings in the Back-Office >
    • Global Configuration Settings >
    • Global Commerce Configuration Options >
    • Configure Global Catalog Settings >
    • Configure Global Related Items Settings
    • User Documentation
      • Solution Architecture
        • Concepts
        • Integration Points
        • Cloud and Infrastructure
      • Concept Guides
        • Business Models
          • Marketplace
          • B2C Website
          • Multiple Websites
        • Catalog and Promotions
          • Master Catalog Management
          • Inventory and Warehouse Management
          • Product Management
            • Product Kits
          • Price Management
          • Promotion Management
          • Search Functions
        • Content Management
          • Web Catalog
          • Landing Page
          • Content Blocks
          • Content Widgets
          • WYSIWYG Editor
        • Customers and Sales
          • Customer Management
          • RFQ and Quote Management
          • Order Management
        • Administration
          • Localization and Translation
            • Translate Content
            • Translate Product Attribute Options
            • Translate Labels, Options, and Messages
          • Customer Permissions
          • Guest Functions
          • Payment Configuration
          • Shipping Configuration
          • Tax Management
          • Storefront and Back-Office Menu Management
          • Checkout Configuration
          • Consent Management
            • Add a Consent Landing Page to a Web Catalog
            • Localize Consents
            • Reports with Accepted Consents
          • Data Import
        • AI and Automation
        • Field Sales App
      • Back-Office
        • Getting Started
          • Community vs Enterprise Edition
          • Application Authentication
            • Log In/Out
            • Restore Password
            • Troubleshoot Login Issues
          • User Menu
            • My User
              • Add OAuth Applications
            • My Configuration
            • My Emails
            • My Calendar
          • Navigation
            • Navigation Basics
            • Record Tables (Grids)
            • Shortcuts
            • Company Structure and Organization Selector
            • Pinbar
            • User Menu
            • Extended Menu
            • Sidebar Panel
            • Flash Notifications
            • Dialog Windows
          • Information Management
            • Create a Record
            • Manage Records
              • View Records
              • Edit Records
              • Delete Records
            • Import Records
            • Export Records
            • Add Notes
            • Create and View Comments
            • Add Attachments
          • E-Commerce Accessibility
        • Dashboard
          • Dashboards
          • Widgets
            • Lead Statistics
            • Opportunity Statistics
            • Average Lifetime Sales
            • Campaign Leads
            • Campaigns by Close Revenue
            • Forecast
            • Leads List
            • Opportunities by Lead Source
            • Opportunities by Status
            • Opportunities List
            • Opportunity Generating Campaigns
            • Quick Launchpad
            • Recent Calls
            • Recent Emails
            • Recently Accessed Account
            • Recently Accessed Contacts
            • Today’s Calendar
            • Sales Orders Volume
            • Sales Orders Number
            • AI Smart Order
        • Customers
          • Accounts
            • Create an Account
            • Manage Accounts
            • Merge Accounts
            • Import Accounts
            • Export Accounts
          • Contacts
            • Export Contacts
            • Import Contacts
          • Customers
            • Create a Customer
            • Create an Address
            • Export Customers
            • Import Customers
            • Configure Price List per Customer
            • Add All Products Page to Storefront Menus per Customer
            • Customize Storefront Menus per Customer
            • Configure Settings per Customer
              • Routing
              • AI Smart Agent
              • Warehouses
              • Search History
              • Product Data Export
              • Sales
          • Customer Groups
            • Configure Price List per Customer Group
            • Add All Products Page to Storefront Menus per Customer Group
            • Customize Storefront Menus per Customer Group
            • Configure Settings per Customer Group
              • Routing
              • AI Agent
              • Warehouses
              • Search History
              • Product Data Export
              • Sales
          • Customer Users
            • Export Customer User Details
            • Import Customer User Details
          • Customer User Roles
          • Business Customers
            • Export Business Customers
            • Import Business Customers
          • Customer User Login Attempts
          • Customer User OAuth Applications
        • Sales
          • Leads
            • Create a Lead
            • Manage Leads
            • Qualify a Lead
            • Import Leads
            • Export Leads
          • Opportunities
            • Create an Opportunity
            • Manage Opportunities
            • Import an Opportunity
            • Export an Opportunity
            • Manage Opportunity Workflow
            • Multi-Currency Opportunities
          • Shopping Lists
          • Request for Quote (RFQ)
            • View a Request for Quote Details
            • View Requests for Quote Summary
            • Manage RFQs
            • Use RFQ Workflows
          • Quotes
            • Create a Quote
              • Create a Quote From Scratch
              • Create a Quote on Customer Request
            • Manage Quotes
            • Send a Guest Quote
            • Use Quotes Workflows
              • Simple Quote Management: Steps and Transitions
              • Quote Management with Approvals: Steps and Transitions
              • Basic Quote Lifecycle Management (When Workflows Are Disabled)
            • Assign a Shipping Method to a Quote
          • Orders
            • Create an Order
            • Import External Orders in JSON Format
            • View Order Details
            • Manage Orders
            • Move an Order Through Its Lifecycle
            • Add a Shipping Tracking Number to the Order
            • View Order Internal Statuses
          • Invoices
          • Price Lists
            • Create a Price List
            • Duplicate a Price List
            • Export Prices from the Price List
            • Import Prices Into the Price List
            • Add a Product Price Manually
            • Generate a Product Price Automatically
            • Use Autocomplete
            • Schedule Price Adjustments
            • Manage Prices in Multiple Currencies
          • Payment Terms
          • Sales Territories
          • Seller Registration Requests
          • Price Calculation Details
        • Products
          • Master Catalog
            • Import Master Catalog Categories Information
            • Export Master Catalog Categories Information
          • Products
            • Create a Simple Product
            • Create a Configurable Product
            • Create a Product Kit
            • Manage Product Visibility
            • Manage Product Grids
              • View Product Details
              • Edit a Product
              • Manage Product Pricing
              • Manage Inventory
            • Manage Product Units
            • Import Product Information
            • Export Product Information
          • Product Families
            • Create a New Product Family
            • Manage Product Attributes in Product Families
          • Product Attributes
            • Import Product Attributes
          • Product Brands
          • Price Attributes
        • Marketing
          • Marketing Lists
          • Email Campaigns
            • Send an Email Campaign via Mailchimp
            • Send Email Campaign via Dotdigital
            • Manage Dotdigital Data Fields and Mappings
          • Marketing Campaigns
          • Promotions
            • Promotions
              • Create Promotions
              • Add Conditions to Promotions
              • Add Expressions to Promotions
              • Manage Discounts in Orders
              • Calculate Order Total in Promotions
              • Review the FAQs
            • Coupons
              • Manage Coupons in Orders
              • Create a Sample Coupon
              • Export Coupons
              • Import Coupons
          • Tracking Websites
          • Web Catalogs
            • Create a Web Catalog
            • Edit a Web Catalog Content Tree
              • Set Up the Homepage, First Level Menu, and Sub Menus
              • Configure Content Variants for the Content Node
              • Customize Web Catalog Contents for Localization, Customer, Customer Group, or Website
              • Preview Web Catalog
            • Build a Custom Web Catalog From Scratch (Example)
            • Use Web Catalog Nodes as Root Nodes (Example)
          • Landing Pages
          • Content Templates
          • Content Blocks
          • Customer Login Pages
          • Content Widgets
          • Digital Assets
          • Search
        • Taxes
          • Product Tax Codes
            • Create a Product Tax Code
            • View Product Tax Code Details
            • Link a Tax Code to a Product
          • Customer Tax Codes
            • Create a Customer Tax Code
            • View Customer Tax Code Details
            • Link a Tax Code to a Customer or Customer Group
          • Taxes (Tax Rates)
            • Create a Tax Rate
            • View and Filter Tax Rates
            • Export Tax Rates
            • Import Taxes Rates
          • Tax Rules
            • Create a Tax Rule
            • View and Filter Tax Rules
            • Export Tax Rules
            • Import Tax Rules
          • Tax Jurisdictions
            • Create a Tax Jurisdiction
            • View and Filter Tax Jurisdictions
        • Inventory
          • Warehouses
          • Manage Inventory Levels
          • Export Inventory Levels and Statuses
          • Import Inventory Levels and Statuses
        • Activities
          • Conversations
          • Emails
            • OroConnector Add-on for Google Workspace
            • OroConnector Add-in for Microsoft 365
          • Tasks
            • Create a Task
            • Manage Tasks
          • Calls
          • Contact Requests
          • Cases
          • Calendar Events
            • Add a Calendar Event
            • Manage Calendar Events
        • Reports and Segments
          • Reports
            • Use System Reports
              • Accounts Reports
              • Leads Reports
              • Opportunities Reports
              • Best Selling Products Report
              • Search (Terms) Report
            • Use Custom Reports
          • Segments
          • Filters
        • System
          • Configuration
            • System Configuration
              • General Setup
              • Integrations
              • Websites
            • CRM Configuration
              • Sales Pipeline
            • Commerce Configuration
              • Customer
              • Guests
              • Catalog
              • Design
              • Product
              • Inventory
              • Sales
              • Taxation
              • Payment
              • Contacts
              • Search
              • Orders
              • Shipping
              • Marketplace
            • Marketing Configuration
              • General Setup
            • Configuration Quick Search
          • User Management
            • Users
              • Create a User
              • Manage Users
              • Configure User System Settings
            • Roles and Permissions
              • Entity and System Capabilities
              • Configure User Roles
              • Field Level Permissions
              • Configure End-to-End Access in Context
            • User Groups
            • Business Units
            • Organizations
              • Create an Organization
              • Manage Organizations
              • Add All Products Page to Storefront Menus per Organization
              • Customize Menus per Organization
              • Configure Organization System Settings
              • Organization Types
            • Login Attempts
            • OAuth Applications
          • Theme Configuration
          • Contact Reasons
          • Contact Groups
          • Emails
            • Templates
            • Notification Rules
          • Integrations
            • Manage Integrations: Payment Method Integration
              • Check/Money Order Service
              • Payment Terms
              • OroPay
              • PayPal Payment Services
              • Apruve Payment Service
              • Authorize.Net Payments Services
              • InfinitePay Payment Service
              • Ingenico Payment Service
              • Stripe
              • Payments at Checkout
            • Manage Integrations: Shipping Method Integration
              • Flat Rate Shipping Integration
              • Fixed Product Shipping Cost Integration
              • UPS Shipping Integration
              • FedEx Shipping Integration
              • DPD Shipping Integration
            • Google Tag Manager Integration
            • Dotdigital Integration
              • Configure Dotdigital Integration
              • Configure Single Sign-on
            • Mailchimp Integration
            • Zendesk Integration
            • LDAP Integration
            • Embedded Forms
            • OpenAPI Specifications
            • AI Integrations
          • Channels
          • Jobs
          • Data Audit
          • Scheduled Tasks
          • Entities
            • Manage Entities
            • Create Entity Fields
              • Basic Entity Field Properties
              • Advanced Entity Field Properties
              • Type-Related Entity Field Properties
              • Examples of Creating Custom Entity Fields
            • Manage Entity Fields
          • Tags Management
            • Tags
            • Taxonomies
          • Menus
          • Storefront Menus
            • Change a Storefront Menu
            • Add All Products Page to Storefront Menus Globally
          • System Calendars
          • Shipping Rules
            • Expression Language for Shipping and Payment Rules
          • Payment Rules
          • Workflows
            • System Workflows
              • Checkout Workflow
              • Alternative Checkout Workflow
              • Single Page Checkout Workflow
              • Quote Workflows
              • RFQ Management Flow Workflow
              • RFQ Submission Flow Workflow
              • Task Flow
              • Unqualified Sales Lead Workflow
              • Contact Request Workflow
              • Seller Registration Request Workflow
              • Seller Product Approval Workflow
              • Conversations Workflow
            • Custom Workflows
            • Workflow Steps, Transitions, and Attributes
          • Processes
          • System Information
          • Consent Management
          • Websites
            • Configure Website System Settings
              • System Configuration
              • Commerce Configuration
            • Create a Website
            • Manage a Website
            • Configure Price Lists per Website
            • Add All Products Page to Storefront Menus per Website
            • Customize Storefront Menus per Website
          • Localization
            • Languages
            • Translations
            • Localizations
          • Alerts
      • Commerce Storefront
        • Navigation and UI
          • General Layout
          • Common Controls
        • Register and Log In
          • Create Account
          • Log In
          • Forgot Password
        • My Account
          • Dashboard
          • My Profile
          • Address Book
          • Users
          • Roles
          • Shopping Lists
            • Shopping Lists for Registered Users
            • Shopping Lists for Guest Users
          • Requests for Quote
            • Create an RFQ
            • Create a Guest RFQ
          • Order History
          • Previously Purchased Products
          • Invoices
          • Quotes
          • Saved Search
          • Manage Payment Profiles (Authorize.Net Customer Profiles)
        • Conversations
        • Orders
          • Create an Order
          • Order via Matrix Form
          • Order a Kit
          • Re-Order Products
        • Quotes
          • Accept a Quote
          • Send Guest Quotes
        • Quick Order Form
        • Checkout
          • Multi Page Checkout
          • Single Page Checkout
          • Guest Checkout
          • Promotions at Checkout
        • Cookie Consent Banner
      • Integrations
        • Pre-Built
          • Payment Integrations
            • Stripe
            • Paypal
            • Authorize
            • Apruve
            • CyberSource
            • InfinitePay
            • Ingenico
          • Shipping Integrations
            • DPD
            • UPS
            • Fedex
          • ERP
            • SAP (B1 and ECC)
            • Epicor Prophet
            • Oracle JD Edwards
            • Eclipse
            • MDS
            • Sage X3
          • Marketing
            • HubSpot
            • Mailchimp
            • Dotdigital
            • Google Analytics
          • PIM
            • Akeneo
          • CRM & Marketplace
            • OroCRM
            • OroMarketplace
            • Salesforce
          • Customer Support
            • Twilio
            • Zendesk
          • AI
            • Google Retail
            • AI Content Generation
          • E-Procurement
            • Greenwing Punchout
          • Reporting and Business Intelligence
            • Integration with Google Looker Studio
            • Integration with Microsoft Power BI Dashboard
            • Tableau Integration
          • More
            • GS1
            • Avatax
            • Hawksearch
            • Marello
        • Custom
          • Oro API
          • Import and Export
          • OroIntegrationBundle
      • Glossary
    Version:
    6.1 (latest)
    • 5.1
    • 6.0
    • 6.1 (latest)
    • 7.0 (dev)

    Configure Global Related Items Settings 

    Hint

    This section is part of the Product Recommendations topic that provides a general understanding of personalized and relevant product suggestions concept in OroCommerce.

    In the Related Items section, you can configure the system settings for related, up-sell, and similar products. These settings may apply globally, per organization, and per website.

    Related products may include accessories, services, and other items that are likely to be purchased in the same order. They facilitate navigation through the product catalog in the back-office and help a buyer find the other products they may be interested in buying.

    Up-sell products may advertise more expensive alternatives to the product, like a newer and more advanced model, upgrades and add-ons that may look tempting when bundled with the product, etc.

    Illustration of Related Products and Upsell Products blocks in the storefront

    In the system configuration, you can:

    • Enable and disable related and up-sell product management for the products.

    • Control the type of the relationship (one-way or bidirectional).

    • Limit the number of items displayed as related, up-sell, or similar.

    Note

    Before configuring the related items settings, add the required related and up-sell products to the desired products as described in the Add Related Items topic. Similar products are displayed automatically following the similar product calculation algorithm.

    To update the related, up-sell, or similar product settings globally:

    1. In the main menu, navigate to System > Configuration.

    2. Select Commerce > Catalog > Related Items in the menu to the left.

      Global Related Items configuration
    3. Clear the Use Default checkbox next to the option to customize the system-wide settings.

    4. In the Related Products section, the following options are available:

      • Enable Related Products — Toggles managing related products on/off. Enabled by default.

      • Assign in Both Directions — When enabled, the products become mutually related. For example, when you add a lightning bulb as a related product for a standing lamp, the relation works both ways and the lamp automatically becomes related item of the lightning bulb. This option is disabled by default.

      • Maximum Number Of Assigned Items — A limit of related products that may be added to any product.

      • Maximum Items — A limit of related products that are shown to a buyer.

        Note

        Some related products may be hidden by the visibility settings. If the list of related products still exceeds the limit, only the specified number of items (top of the list) will be shown.

      • Minimum Items — The minimum number of related products that may be shown to the buyer. If the actual number of products is less than this value, the related products section is hidden in the storefront for the product.

      • Show Add Button — Enables a buyer to order a related product from the related products section in the main product details. When the option is disabled, a buyer needs to open the related product details page before they can add it to the shopping list.

      • Use Slider On Mobile — When enabled, one related product is displayed below the main product information. Other related products are accessible using the horizontal slider. Click < and > to slide through the related products.

    1. In the Up-Sell Products section, the following options are available:

      • Enable Up-Sell Products — Toggles managing up-sell products on/off. Enabled by default.

      • Maximum Number Of Assigned Items — A limit of related items that may be added to any product.

      • Maximum Items — A limit of up-sell products that are shown to the buyer.

        Note

        Some related items may be hidden by the visibility settings. If the list of up-sell products still exceeds the limit, only the specified number of items (top of the list) will be shown.

      • Minimum Items — The minimum number of up-sell products that may be shown to the buyer. If the actual number of products is less than this value, the up-sell products section is hidden in the storefront for the product.

      • Show Add Button — Enables a buyer to order the product from the up-sell products section in the main product details. When disabled, a buyer needs to open the up-sell product details page before they can add it to the shopping list.

      • Use Slider On Mobile — When the option is enabled, one up-sell product is displayed below the main product information. Other up-sell products are accessible using the horizontal slider. Click < and > to slide through the up-sell products.

    Note

    Similar Products and Similar Products in Shopping Lists are available for the OroCommerce Enterprise edition if Elasticsearch is used as the search engine.

    1. In the Similar Products section, the following options are available:

      • Enable Similar Products — Toggles managing similar products on/off. Enabled by default.

      • Maximum Items — A limit of similar products that are shown to a buyer.

        Note

        Some similar products may be hidden by the visibility settings. If the list of similar products still exceeds the limit, only the specified number of items (top of the list) will be shown.

      • Minimum Items — The minimum number of similar products that may be shown to the buyer. If the actual number of products is less than this value, the similar products section is hidden in the storefront for the product.

      • Show Add Button — Enables a buyer to order a similar product from the similar products section in the main product details. When the option is disabled, a buyer needs to open the similar product details page before they can add it to the shopping list.

      • Use Slider On Mobile — When enabled, one similar product is displayed below the main product information. Other similar products are accessible using the horizontal slider. Click < and > to slide through the similar products.

      • Product Name Boost — A boost factor for the product name, the boost is applied for each matched word. Leave the field empty to disable the boost.

      • Category Boost — A boost factor for the product category. Leave the field empty to disable the boost.

      • Parent Category Boost — A boost factor for the parent of a product category. Leave the field empty to disable the boost.

      • Second Level Parent Category Boost — A boost factor for the second level parent of a product category. Leave the field empty to disable the boost.

    2. In the Similar Products in Shopping Lists, the following options are available:

      • Enable Similar Products in Shopping Lists – Enabling this option add a block of Similar Products to the shopping list page.

      • Maximum Items — A limit of similar products that are shown to a buyer on the shopping list page.

      • Minimum Items — The minimum number of similar products that may be shown to the buyer on the shopping list page..

      • Show Add Button — Enables a buyer to order a similar product directly from the shopping list page.

      • Use Slider On Mobile — When enabled, one similar product is displayed below the main product information. Other similar products are accessible using the horizontal slider. Click < and > to slide through the similar products.

      • Product Name Boost — A boost factor for the product name, the boost is applied for each matched word. Leave the field empty to disable the boost.

      • Category Boost — A boost factor for the product category. Leave the field empty to disable the boost.

      • Parent Category Boost — A boost factor for the parent of a product category. Leave the field empty to disable the boost.

      • Second Level Parent Category Boost — A boost factor for the second level parent of a product category. Leave the field empty to disable the boost.

      Illustration of the Similar Products block on the shopping list page
    3. Click Save.

    Business Tip

    Technology is driving digital transformation in key industries, such as manufacturing. Learn how eCommerce fits into your manufacturing digital transformation strategy.

    Get the latest Oro News

    • OroCommerce
    Compliances
    • Compliances
    • pci-dssfooter1SOCfooter1

    About Us

    • About us
    • Partners
    • Events
    • Careers
    • Bug Bounty

    Certifications

    • PCI DSS
    • SOC2

    Services

    • Oro Services
    • Training

    More Resources

    • Guides & Reports
    • Documentation
    • OroCommerce Blog

    Compliances

    pci-dssfooter1 SOCfooter1

    Follow Oro

    Oro GitHub Oro linkedin Oro twitter Oro Youtube
    © 2024 Oro, Inc. All Rights Reserved
    Terms & Conditions Privacy Policy Data Protection Framework Certification

    Follow Oro

    Oro GitHub Oro linkedin Oro twitter Oro Youtube
    Back to top