Skip to content

Adobe Commerce Integration with Marqo

This guide will help you integrate Marqo's powerful search capabilities with your Adobe Commerce (formerly Magento) store. Marqo provides a seamless integration that enhances your store's search functionality with advanced features like semantic search, filtering, and relevance tuning.

Prerequisites

  • An active Adobe Commerce store
  • Admin access to your Adobe Commerce instance
  • A Marqo account (if you don't have one, sign up here)
  • Marqo Pixel installed on your store (see Pixel Installation Guide)
  • A Marqo API key (available in your Marqo Console)

Integration Steps

1. Request Adobe Endpoint

Before beginning the integration, you'll need to request a dedicated Adobe integration endpoint from Marqo support:

  1. Visit our support portal
  2. Select sev 5 and use the subject line "Integration Support - Adobe Endpoint"
  3. Specify that you need an Adobe Commerce integration endpoint
  4. Provide your Marqo account details and Adobe Commerce store URL

Our support team will provide you with a dedicated endpoint URL and configuration details within 2-3 business days.

2. Install OpenSearch Plugin

Adobe Commerce uses OpenSearch for its search functionality. We'll use this to integrate Marqo:

  1. Log in to your Adobe Commerce admin panel
  2. Navigate to System > Web Setup Wizard > Component Manager
  3. Search for "OpenSearch"
  4. Install the OpenSearch plugin if not already installed
  5. Once installed, go to Stores > Configuration > Catalog > Catalog Search
  6. Select "OpenSearch" as the search engine
  7. In the configuration:
  8. Set the Server Hostname to the endpoint URL provided by Marqo support
  9. Set the Server Port to 443
  10. Enable Enable SSL
  11. For the API Key, use your Marqo API key from the Marqo Console

3. Configure and Index Data

After installation, you'll need to configure the search settings and index your catalog:

  1. In the Adobe Commerce admin panel, go to System > Index Management
  2. Reindex your catalog data using the index management interface
  3. Wait for the indexing process to complete
  4. Go to Stores > Configuration > Catalog > Catalog Search
  5. Configure the following settings:
  6. Set Minimum Query Length to 2
  7. Enable Enable Search Suggestions
  8. Set Search Suggestions Results Count to 5
  9. Enable Enable Search Recommendations

4. Verify Integration

To ensure everything is working correctly:

  1. Clear your Adobe Commerce cache:
  2. Go to System > Cache Management
  3. Select all caches
  4. Click "Flush Cache Storage"
  5. Test the search functionality on your store's frontend
  6. Verify that search results are being returned from Marqo
  7. Check that filters and facets are working as expected

Troubleshooting

If you encounter any issues during the integration:

  1. Verify that your Marqo API key is correct
  2. Ensure the endpoint URL is properly configured
  3. Check that your SSL certificate is valid
  4. Verify that your firewall allows connections to the Marqo endpoint
  5. Contact Marqo Support if issues persist

Support

For any questions or issues with the integration, please contact our support team:

Additional Resources